| Pakiet | fl.managers |
| Interfejs | public interface IFocusManagerComponent |
| Implementory | Button, ColorPicker, ComboBox, DataGrid, LabelButton, List, NumericStepper, ScrollPane, SelectableList, Slider, TextArea, TextInput, TileList |
| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Klasa UIComponent zawiera podstawową implementację tego interfejsu, ale nie implementuje go w pełni, ponieważ nie wszystkie obiekty UIComponent mogą stawać się aktywne. Składniki pochodne względem klasy UIComponent muszą implementować tę klasę, aby mogły stawać się aktywne. Aby włączyć aktywność, należy dodać instrukcję implements IFocusManagerComponent do definicji składnika pochodnego względem klasy UIComponent.
Powiązane elementy interfejsu API
| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| focusEnabled : Boolean
Pobiera lub ustawia wartość Boolean, która określa, czy wybrany składnik może przyjmować aktywność od menedżera aktywności. | IFocusManagerComponent | ||
| mouseFocusEnabled : Boolean [tylko do odczytu]
Pobiera wartość Boolean wskazującą, czy składnik wybrany za pomocą myszy może stawać się aktywny. | IFocusManagerComponent | ||
| tabEnabled : Boolean [tylko do odczytu]
Pobiera wartość Boolean, która wskazuje, czy możliwe jest aktywowanie tego składnika poprzez naciśnięcie klawisza Tab. | IFocusManagerComponent | ||
| tabIndex : int [tylko do odczytu]
Pobiera kolejność, w której składnik stanie się aktywny, jeśli właściwość tabEnabledis jest ustawiona na true. | IFocusManagerComponent | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Rysuje graficzny wskaźnik aktywności. | IFocusManagerComponent | ||
Czyni składnik aktywnym. | IFocusManagerComponent | ||
focusEnabled | właściwość |
focusEnabled:Boolean| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera lub ustawia wartość Boolean, która określa, czy wybrany składnik może przyjmować aktywność od menedżera aktywności.
Aby składnik mógł przyjmować aktywność od menedżera aktywności, należy ustawić te właściwość na true. Aby składnik nie mógł stawać się aktywny, należy ustawić tę właściwość na false. Gdy właściwość focusEnabled jest ustawiona na false, menedżer aktywności ignoruje składnik przez cały czas jego istnienia i nie monitoruje go pod kątem zmian następujących właściwości: tabEnabled, tabChildren i mouseFocusEnabled.
Można wykorzystać właściwości focusEnabled, aby uniemożliwić składnikom podrzędnym, które implementują interfejs IFocusManagerComponent, przyjmowanie aktywności od menedżera aktywności. W tym celu należy ustawić tę właściwość na false przed użyciem metody addChild() w celu dodania składnika podrzędnego do listy wyświetlania. Należy pamiętać, że ustawienie tej właściwości na false przed dodaniem składnika do listy wyświetlania spowoduje, że menedżer aktywności będzie nadal ignorował składnik, nawet jeśli ta właściwość zostanie później zmieniona na true.
Uwaga: Mimo ustawienia tej właściwości false można nadal ustawiać aktywność drogą programową, używając metody setFocus().
Implementacja
public function get focusEnabled():Boolean public function set focusEnabled(value:Boolean):voidmouseFocusEnabled | właściwość |
mouseFocusEnabled:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera wartość Boolean wskazującą, czy składnik wybrany za pomocą myszy może stawać się aktywny.
Należy ustawić tę właściwość na true, aby składniki wybierane myszą były aktywowane. Ustawienie tej właściwości false powoduje, że składniki wybierane myszą nie będą stawały się aktywne. Gdy ta właściwość jest ustawiona na false, a składnik zostanie wybrany za pomocą myszy, aktywność zostanie przeniesiona do pierwszego składnika nadrzędnego, w którym ta właściwość jest ustawiona na true.
Implementacja
public function get mouseFocusEnabled():BooleantabEnabled | właściwość |
tabEnabled:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera wartość Boolean, która wskazuje, czy możliwe jest aktywowanie tego składnika poprzez naciśnięcie klawisza Tab. Wartość true oznacza, że naciśnięcie klawisza Tab może spowodować przeniesienie aktywności na ten składnik; wartość false oznacza, że za pomocą klawisza Tab nie można aktywować tego składnika.
Mimo ustawienia tej wartości na false aktywowanie składnika jest możliwe za pomocą myszy lub poprzez wywołanie metody setFocus().
Implementacja
public function get tabEnabled():BooleantabIndex | właściwość |
tabIndex:int [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Pobiera kolejność, w której składnik stanie się aktywny, jeśli właściwość tabEnabledis jest ustawiona na true. Właściwość tabIndex ma domyślnie wartość -1, co oznacza że obiekt nie ma indeksu klawisza Tab i będzie aktywowany zgodnie z kolejnością Z.
Właściwość tabIndex może być także nieujemną liczbą całkowitą. W tym przypadku obiekty są porządkowane zgodnie z właściwościami tabIndex w kolejności rosnącej. Obiekt z wartością właściwości tabIndex równą 1 ma pierwszeństwo względem obiektu z wartością właściwości tabIndex równą 2. Jeśli dwa obiekty mają tę samą wartość tabIndex, pierwszeństwo będzie miał obiekt wcześniejszy w domyślnej kolejności aktywacji klawiszem Tab.
Wartością domyślną jest -1.
Implementacja
public function get tabIndex():intdrawFocus | () | metoda |
public function drawFocus(draw:Boolean):void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Rysuje graficzny wskaźnik aktywności.
Ta metoda jest wywoływana przez menedżera aktywności, gdy składnik staje się aktywny. Składnik powinien rysować lub ukrywać grafikę wskazującą, że jest on aktywny.
Parametry
draw:Boolean — Wartość true nakazuje narysowanie wskaźnika, wartość false nakazuje jego ukrycie.
|
setFocus | () | metoda |
public function setFocus():void| Wersja języka: | ActionScript 3.0 |
| Wersja produktu: | Flash CS3 |
| Wersje środowiska wykonawczego: | Flash Player 9.0.28.0, AIR 1.0 |
Czyni składnik aktywnym.
Ta metoda jest wywoływana przez menedżera aktywności, gdy składnik staje się aktywny. Składnik może z kolei uaktywnić swój składnik wewnętrzny.
Tue Jun 12 2018, 12:06 PM Z