| Pakiet | flash.display |
| Klasa | public class NativeMenuItem |
| Dziedziczenie | NativeMenuItem  EventDispatcher Object |
| Podklasy | ContextMenuItem |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Pozycją menu może być polecenie, podmenu lub linia separatora:
- W celu utworzenia elementu polecenia należy wywołać konstruktor NativeMenuItem, podając ciąg znaków jako etykietę oraz wartość
falsedla parametruisSeparator. - W celu utworzenia podmenu, należy utworzyć element polecenia dla menu nadrzędnego oraz przypisać obiekt NativeMenu submenu do właściwości
submenuelementu. Możliwe jest również wywołanie metodyaddSubmenu()nadrzędnego obiektu NativeMenu w celu utworzenia elementu i jednoczesnego ustawienia właściwościsubmenu. - W celu utworzenia separatora należy wywołać konstruktor NativeMenuItem podając pusty ciąg znaków dla etykiety oraz wartość
truedla parametruisSeparator.
Należy nasłuchiwać zdarzeń select na elemencie lub menu nadrzędnym w celu wykrycia momentu, gdy polecenie menu zostanie wybrane. Ani submenu ani separatory nie wywołują zdarzeń wybierania. Należy wykrywać zdarzenia preparing w celu określenia, kiedy element menu ma zostać wyświetlony lub uaktywniony za pomocą odpowiednika klawisza.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| checked : Boolean
Określa, czy ta pozycja menu wyświetla znak zaznaczenia. | NativeMenuItem | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| data : Object
Dowolny obiekt danych skojarzony z tą pozycją menu. | NativeMenuItem | ||
| enabled : Boolean
Określa, czy ta pozycja menu jest włączona. | NativeMenuItem | ||
| isSeparator : Boolean [tylko do odczytu]
Informuje, czy ten element jest linią separatora menu. | NativeMenuItem | ||
| keyEquivalent : String
Klawisz skrótu dla tej pozycji menu. | NativeMenuItem | ||
| keyEquivalentModifiers : Array
Tablica kodów klawiszy dla modyfikatorów odpowiedników klawiszy. | NativeMenuItem | ||
| label : String
Ciąg znaków wyświetlania dla tej pozycji menu. | NativeMenuItem | ||
| menu : NativeMenu [tylko do odczytu]
Menu zawierające ten element. | NativeMenuItem | ||
| mnemonicIndex : int
Położenie znaku mnemonicznego w etykiecie pozycji menu. | NativeMenuItem | ||
| name : String
Nazwa tej pozycji menu. | NativeMenuItem | ||
| submenu : NativeMenu
Podmenu skojarzone z tą pozycją menu. | NativeMenuItem | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Tworzy nowy obiekt NativeMenuItem. | NativeMenuItem | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
Tworzy kopię obiektu NativeMenuItem. | NativeMenuItem | ||
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
[przesłanianie]
Zwraca ciąg zawierający wszystkie właściwości obiektu NativeMenuItem. | NativeMenuItem | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | ||
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Wywoływane przez ten obiekt NativeWindow tuż przed wyświetleniem menu zawierającego element. | NativeMenuItem | |||
| Wywoływane przez ten obiekt NativeMenuItem, gdy zostaje naciśnięty jego odpowiednik klawisza, a także bezpośrednio przed wyświetleniem menu zawierającego dany element. | NativeMenuItem | |||
| Wywoływane zawsze w momencie wybrania pozycji menu przez użytkownika. | NativeMenuItem | |||
checked | właściwość |
data | właściwość |
data:Object| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Dowolny obiekt danych skojarzony z tą pozycją menu.
Możliwe jest przypisanie dowolnego obiektu do tej właściwości. Przypisany obiekt nie jest stosowany przez system menu, aczkolwiek jest dostępny dla kodu obsługi zdarzeń (dzięki właściwości target obiektu zdarzenia). Domyślnie ta właściwość ma wartość null.
Implementacja
public function get data():Object public function set data(value:Object):void enabled | właściwość |
isSeparator | właściwość |
isSeparator:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Raportuje czy ten element jest linią separatora menu.
Tworzy linię separatora poprzez ustawienie parametru isSeparator w konstruktorze NativeMenuItem na wartość true.
Implementacja
public function get isSeparator():Boolean keyEquivalent | właściwość |
keyEquivalent:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Klawisz skrótu dla tej pozycji menu.
Aby przypisać skrót bez modyfikatora w postaci klawisza Shift, należy ustawić klawisz skrótu keyEquivalent z małą literą. Ustawienie wielkiej litery powoduje przypisanie skrótu z modyfikatorem Shift.
Modyfikator odpowiednika klawiszowego (klawisz Ctrl w systemie Windows lub Linux oraz klawisz Command w systemie Mac X) jest zawarty domyślnie jako część odpowiednika klawiszowego. Jeżeli zachodzi potrzeba użycia odpowiednika klawiszowego bez modyfikatora, należy ustawić właściwość keyEquivalentModifiers na pusty element Array.
Implementacja
public function get keyEquivalent():String public function set keyEquivalent(value:String):void keyEquivalentModifiers | właściwość |
keyEquivalentModifiers:Array| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Tablica kodów klawisza dla modyfikatorów odpowiednika klawiszowego.
Należy użyć stałych, zdefiniowanych w klasie Keyboard w celu określenia kodów modyfikatora odpowiednika klawiszowego. Poprawne są następujące klawisze modyfikujące:
Keyboard.ALTERNATEKeyboard.COMMANDKeyboard.CONTROL
Jeśli nie zostaną przypisane żadne modyfikatory, wówczas domyślnie klawisz Keyboard.CONTROL zostanie przypisany w systemie Windows lub Linux, a klawisz Keyboard.COMMAND w systemie Mac OS X. Jeśli odpowiednik klawiszowy nie ma uwzględniać tych modyfikatorów, dla tej właściwości należy ustawić pustą tablicę.
Jeśli dla właściwości keyEquivalent zostanie przypisana wielka litera, klawisz Shift będzie automatycznie używany jako modyfikator. Ustawienie pustej tablicy dla właściwości keyEquivalentModifier nie powoduje usunięcia funkcji modyfikatora klawisza Shift.
Implementacja
public function get keyEquivalentModifiers():Array public function set keyEquivalentModifiers(value:Array):voidPowiązane elementy interfejsu API
label | właściwość |
menu | właściwość |
menu:NativeMenu [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Menu zawierające ten element.
Implementacja
public function get menu():NativeMenu mnemonicIndex | właściwość |
mnemonicIndex:int| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Położenie znaku mnemonicznego w etykiecie pozycji menu.
Znak w określonym położeniu stanie się wówczas znakiem mnemonicznym dla pozycji menu. Indeks jest zerowy, zatem pierwszy znak ma indeks 0.
Ta właściwość jest ignorowana w systemie operacyjnym, który nie stosuje mnemoników menu.
Implementacja
public function get mnemonicIndex():int public function set mnemonicIndex(value:int):void name | właściwość |
name:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Nazwa tej pozycji menu.
Wartość nazwy nie jest wyświetlana i może być wykorzystana jako identyfikator niezależny od ustawień narodowych. Nazwa nie jest przypisywana automatycznie.
Implementacja
public function get name():String public function set name(value:String):void submenu | właściwość |
submenu:NativeMenu| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Podmenu skojarzone z tą pozycją menu.
Przypisanie obiektu NativeMenu do tej właściwości powoduje zmianę wyglądu oraz zachowania tej pozycji menu. Element podmenu będzie wyświetlać ikonę podmenu i nie będzie już wywoływać zdarzeń wybierania.
Uwaga: Dodanie menu jako podmenu jego samego (utworzenie odwołania cyklicznego) może spowodować zawieszenie aplikacji.
Implementacja
public function get submenu():NativeMenu public function set submenu(value:NativeMenu):voidPowiązane elementy interfejsu API
NativeMenuItem | () | Konstruktor |
public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Tworzy nowy obiekt NativeMenuItem.
W celu utworzenia komendy menu należy ustawić parametr label na ciąg znaków, zawierający tabelę wyświetlania, oraz ustawić właściwość isSeparator na wartość false.
W celu utworzenia komendy podmenu należy utworzyć element komendy, a następnie przypisać obiekt NativeMenu podmenu do właściwości submenu tego elementu. Należy dodać element do menu macierzystego.
W celu utworzenia separatora należy ustawić parametr label na pusty ciąg znaków, a następnie ustawić właściwość isSeparator na wartość true.
Możliwe jest dodawanie i usuwanie elementów z menu przy zastosowaniu metod NativeMenu addItem() i removeItem().
label:String (default = " | |
isSeparator:Boolean (default = false)true, lub na wartość false w innym przypadku.
|
Powiązane elementy interfejsu API
clone | () | metoda |
public function clone():NativeMenuItem| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Tworzy kopię obiektu NativeMenuItem.
ZwracaNativeMenuItem |
toString | () | metoda |
displaying | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.DISPLAYING| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywołane przez ten obiekt NativeWindow tuż przed wyświetleniem menu zawierającego element.
Zdarzenie preparing ma pierwszeństwo przed zdarzeniem displaying i oferuje dodatkowe funkcje. Należy wykrywać zdarzenie preparing lub zdarzenie displaying, ale nie oba te zdarzenia.
Event.DISPLAYING definiuje wartość właściwości type obiektu zdarzenia displaying.
Uwaga: To zdarzenie nie przechodzi „fazy przechwytywania” i jest wywoływane bezpośrednio w węźle będącym miejscem docelowym, niezależnie od tego, czy węzeł ten znajduje się na liście wyświetlania.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt, który ma zostać wyświetlony. |
preparing | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.PREPARING| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2.6 |
Wywoływane przez ten obiekt NativeMenuItem, gdy zostaje naciśnięty jego odpowiednik klawisza, a także bezpośrednio przed wyświetleniem menu zawierającego dany element.
Należy wykrywać to zdarzenie w celu uaktualnienia elementu przed wyświetleniem menu zawierającego ten element lub w momencie naciśnięcia przez użytkownika odpowiednika klawisza. Zdarzenie preparing jest wywoływane przed zakończeniem przetwarzania odpowiednika klawisza. W detektorze zdarzenia preparing można włączać, wyłączać lub usuwać element menu, a te zmiany będą obowiązywać podczas przetwarzania odpowiednika klawisza. Na przykład w przypadku usunięcia lub wyłączenia tego elementu menu sekwencja zdarzeń zostaje efektywnie anulowana i nie jest wywoływane żadne zdarzenie select. Zdarzenie preparing jest również wywoływane przez inne elementy w menu.
Zdarzenie preparing ma pierwszeństwo przed zdarzeniem displaying i oferuje dodatkowe funkcje. Należy wykrywać zdarzenie preparing lub zdarzenie displaying, ale nie oba te zdarzenia.
Event.PREPARING definiuje wartość właściwości type obiektu zdarzenia preparing.
Uwaga: To zdarzenie nie przechodzi „fazy przechwytywania” i jest wywoływane bezpośrednio w węźle będącym miejscem docelowym, niezależnie od tego, czy węzeł ten znajduje się na liście wyświetlania.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Obiekt, który wywołał to zdarzenie. |
target | Obiekt, który wywołał to zdarzenie. |
select | Zdarzenie |
flash.events.Eventwłaściwość Event.type =
flash.events.Event.SELECT| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane zawsze w momencie wybrania pozycji menu przez użytkownika.
Zdarzenie select będzie propagować z tego elementu do swego menu oraz w górę lub przez łańcuch menu nadrzędnego do menu głównego obiektu. Właściwość target obiektu zdarzeń odwołuje się do tego obiektu NativeMenuItem; właściwość currentTarget odwołuje się do obiektu wywołującego (będzie to albo ten element NativeMenuItem lub obiekt nadrzędny NativeMenu).
Uwaga: Jeśli okno zawierające menu pracuje w trybie pełnego ekranu (stage.displayState == StageDisplayState.FULL_SCREEN), wówczas obiekt NativeMenuItem nie wywołuje zdarzenia select w momencie, gdy użytkownik za pomocą klawiatury wybierze pozycję menu.
Event.SELECT definiuje wartość właściwości type obiektu zdarzenia select.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
target | Obiekt, w którym został wybrany element. |
Tue Jun 12 2018, 12:06 PM Z