NativeMenu

Pakiet	flash.display
Klasa	public class NativeMenu
Dziedziczenie	NativeMenu EventDispatcher Object
Podklasy	ContextMenu

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Klasa NativeMenu zawiera metody i właściwości służące do definiowania menu natywnych.

Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich komputerowych systemach operacyjnych, ale nie jest obsługiwana na urządzeniach przenośnych ani na urządzeniach telewizyjnych ze środowiskiem AIR. W czasie wykonywania można sprawdzić, czy funkcja jest obsługiwana, odczytując właściwość NativeMenu.isSupported. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.

Menu natywne to menu sterowane i rysowane przez system operacyjny, a nie przez aplikację. Środowisko AIR obsługuje następujące typy menu natywnych:

Menu aplikacji są obsługiwane w systemie OS X. Właściwość NativeApplication.supportsMenu umożliwia sprawdzenie, czy system operacyjny hosta obsługuje menu aplikacji. Menu aplikacji jest wyświetlane na pasku menu na górze pulpitu (biurka) systemu Mac OS X. System OS X udostępnia domyślne menu każdej aplikacji, jednak wiele z poleceń tego menu nie działa. Można dodawać detektory zdarzeń do domyślnych elementów menu, zastępować poszczególne menu i ich elementy, a nawet całkowicie zastąpić domyślne menu. Dostęp do menu aplikacji uzyskuje sie poprzez właściwość menu obiektu NativeApplication.
Menu okien są obsługiwane w systemach Windows i Linux. Właściwość NativeWindow.supportsMenu umożliwia sprawdzenie, czy system operacyjny hosta obsługuje menu okien. Menu okna jest wyświetlane pod paskiem tytułu okna. Obszar zajęty przez menu nie należy do stołu montażowego okna. Aplikacje nie mogą rysować w tym obszarze. Przypisanie menu do okna odbywa się przy użyciu właściwości menu obiektu NativeWindow.
Ikony menu Docku są obsługiwane w systemie OS X. Właściwość NativeApplication.supportsDockIcon umożliwia sprawdzenie, czy system operacyjny hosta obsługuje ikony Docku. Elementy w menu Docku są wyświetlane nad domyślnymi elementami udostępnianymi przez system operacyjny. Nie jest możliwy dostęp do elementów domyślnych z kodu aplikacji. Menu przypisuje się do właściwości menu obiektu DockIcon aplikacji.
Menu ikon zasobnika systemowego są obsługiwane w systemie Windows i w większości systemów operacyjnych Linux. Właściwość NativeWindow.supportsSystemTrayIcon umożliwia sprawdzenie, czy system operacyjny hosta obsługuje menu ikon zasobnika systemowego. Menu ikony zasobnika systemowego jest wyświetlane w odpowiedzi na kliknięcie ikony prawym przyciskiem myszy, podobnie jak menu kontekstowe. Menu przypisuje się do właściwości menu obiektu SystemTrayIcon aplikacji.
Menu kontekstowe są obsługiwane we wszystkich systemach operacyjnych. Menu kontekstowe są wyświetlane w odpowiedzi na zdarzenie w interfejsie użytkownika, takie jak kliknięcie prawym przyciskiem obiektu InteractiveObject wyświetlanego w aplikacji lub kliknięcie go, gdy naciśnięty jest klawisz Command. Na różnych platformach systemowych i sprzętowych do wyświetlania menu używane są różne mechanizmy interfejsu użytkownika. Menu przypisuje się do właściwości contextMenu obiektu InteractiveObject. W środowisku AIR menu kontekstowe można utworzyć przy użyciu klasy NativeMenu albo klasy ContextMenu. W programie Flash Player używana może być tylko klasa ContextMenu. Menu ContextMenu w środowisku AIR nie mają wbudowanych elementów; domyślne menu kontekstowe nie jest wyświetlane.
Menu wyskakujące są obsługiwane we wszystkich systemach operacyjnych. Menu wyskakujące pod względem funkcjonalnym nie różnią się od menu kontekstowych, ale wyświetlane są w odpowiedzi na wywołanie metody display() obiektu menu, a nie na zdarzenie w interfejsie użytkownika. Menu wyskakujące nie jest powiązane z żadnym innym obiektem. Wystarczy utworzyć menu natywne i wywołać metodę display().

Obiekt menu zawiera elementy menu. Elementem menu może być polecenie, podmenu lub linia separatora. Do dodawania elementów do menu służą metody addItem() i addItemAt(). Kolejność wyświetlania elementów menu odpowiada kolejności zawartej w tablicy items menu.

Aby utworzyć podmenu, należy dodać element menu do obiektu menu nadrzędnego. Obiekt menu reprezentujący podmenu należy przypisać do właściwości submenu odpowiedniego elementu menu nadrzędnego.

Uwaga: Menu główne okna i menu aplikacji mogą zawierać tylko elementy podmenu; elementy menu, które nie reprezentują podmenu, nie mogą być wyświetlane i są sprzeczne z oczekiwaniami użytkownika względem menu tego typu.

Menu wysyłają zdarzenia select w momencie wyboru elementu polecenia menu lub jego submenu. (Nie jest możliwy wybór elementów submenu i separatora). Właściwość target obiektu zdarzeń odwołuje się do wybranego elementu.

Menu wywołują zdarzenia preparing bezpośrednio przed wyświetleniem menu i w momencie naciśnięcia odpowiednika klawisza dołączonego do jednego z elementów w menu. Można wykorzystać to zdarzenie w celu aktualizacji zawartości menu w oparciu o stan obecny aplikacji.

Uwaga: Jeśli używana jest architektura Flex Framework, należy wziąć pod uwagę możliwość użycia klasy FlexNativeMenu. Zwykle łatwiej jest zadeklarować menu w języku MXML niż pisać odpowiedni kod ActionScript tworzący strukturę menu element po elemencie.

Powiązane elementy interfejsu API

flash.display.InteractiveObject.contextMenu
flash.display.NativeMenuItem
flash.display.NativeWindow.menu
flash.desktop.DockIcon
flash.desktop.SystemTrayIcon
flash.desktop.NativeApplication.menu
flash.desktop.NativeApplication.icon
mx.controls.FlexNativeMenu

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		isSupported : Boolean [statyczny] [tylko do odczytu] Wskazuje, czy w systemie klienckim obsługiwana jest jakakolwiek forma menu natywnego.	NativeMenu
		items : Array Tablica obiektów NativeMenuItem w tym menu.	NativeMenu
		numItems : int [tylko do odczytu] Liczba obiektów NativeMenuItem w tym menu.	NativeMenu
		parent : NativeMenu [tylko do odczytu] Menu macierzyste.	NativeMenu

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		NativeMenu() Tworzy nowy obiekt NativeMenu.	NativeMenu
		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
		addItem(item:NativeMenuItem):NativeMenuItem Dodaje element menu na dół tego menu.	NativeMenu
		addItemAt(item:NativeMenuItem, index:int):NativeMenuItem Wstawia element menu w określonej pozycji.	NativeMenu
		addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem Dodaje podmenu do menu przez wstawienie nowej pozycji menu.	NativeMenu
		addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem Dodaje podmenu do menu przez wstawienie nowego elementu menu na określonej pozycji.	NativeMenu
		clone():NativeMenu Tworzy kopię menu i wszystkich jego elementów.	NativeMenu
		containsItem(item:NativeMenuItem):Boolean Raportuje czy to menu zawiera określoną pozycją.	NativeMenu
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		display(stage:Stage, stageX:Number, stageY:Number):void Wyświetla to menu w określonym położeniu.	NativeMenu
		getItemAt(index:int):NativeMenuItem Pobiera pozycję menu o podanym indeksie.	NativeMenu
		getItemByName(name:String):NativeMenuItem Pobiera element menu o określonej nazwie.	NativeMenu
		getItemIndex(item:NativeMenuItem):int Pobiera położenie określonego elementu.	NativeMenu
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		removeAllItems():void Usuwa z memu wszystkie elementy.	NativeMenu
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		removeItem(item:NativeMenuItem):NativeMenuItem Usuwa określoną pozycję menu.	NativeMenu
		removeItemAt(index:int):NativeMenuItem Usuwa a następnie zwraca pozycję menu na określony indeks.	NativeMenu
		setItemIndex(item:NativeMenuItem, index:int):void Przesuwa pozycję menu na określoną pozycję.	NativeMenu
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher
displaying	Wywoływane przez ten obiekt NativeMenu tuż przed wyświetleniem menu.	NativeMenu
preparing	Wywoływane przez obiekt NativeMenu, gdy zostaje naciśnięty odpowiednik klawisza, a także bezpośrednio przed wyświetleniem menu.	NativeMenu
select	Wywoływane przez ten obiekt NativeMenu, gdy zostanie wybrana jedna z jego pozycji menu lub pozycja jednego z jego menu podrzędnych w porządku malejącym.	NativeMenu

Szczegół właściwości

isSupported

właściwość

isSupported:Boolean [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 2.0

Wskazuje, czy w systemie klienckim obsługiwana jest jakakolwiek forma menu natywnego.

Implementacja
public static function get isSupported():Boolean

Powiązane elementy interfejsu API

flash.display.NativeWindow.supportsMenu
flash.desktop.NativeApplication

items

właściwość

items:Array

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Tablica obiektów NativeMenuItem w tym menu.

Tablica jest posortowana w kolejności wyświetlania.

Uwaga: Ta właściwość w środowisku AIR 1.0 jest przeznaczona tylko do odczytu. W wersji 1.1 środowiska AIR wprowadzono także możliwość zmiany jej wartości.

Implementacja
public function get items():Array
public function set items(value:Array):void

numItems

właściwość

numItems:int [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Liczba obiektów NativeMenuItem w tym menu.

Implementacja
public function get numItems():int

parent

właściwość

parent:NativeMenu [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Menu nadrzędne.

Właściwość parent głównego menu (szczytowy poziom) ma wartość null.

Implementacja
public function get parent():NativeMenu

Konstruktor Szczegół

()

Konstruktor

public function NativeMenu()

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Tworzy nowy obiekt NativeMenu.

Szczegół metody

addItem

()

metoda

public function addItem(item:NativeMenuItem):NativeMenuItem

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Dodaje element menu na dół tego menu.

Podczas tworzenia menu kontekstowego można dodawać do niego obiekty NativeMenuItem albo ContextMenuItem. Jednak zaleca się stosowane w danym menu kontekstowym tylko jednego typu obiektów, tak aby wszystkie pozycje w menu miały te same właściwości.

Uwaga: dodanie elementu do menu może spowodować zawieszenie aplikacji, jeśli podmenu danego elementu jest ustawione na menu, w którym jest on wstawiany (odniesienie cykliczne).

Parametry

item:NativeMenuItem — Obiekt NativeMenuItem, który zostanie dodany na dole tego menu.

Zwraca

NativeMenuItem

Zgłasza

	`ArgumentError` — Jeżeli właściwość `item` ma wartość `null`.

	`ArgumentError` — Jeśli element `item` należy do innego menu.

addItemAt

()

metoda

public function addItemAt(item:NativeMenuItem, index:int):NativeMenuItem

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Wstawia element menu w określonej pozycji. Pozycja jest indeksowana od góry. Aby wstawić element znajdujący się na górze menu, należy ustawić dla parametru index wartość zero. Pozycje menu są indeksowane od góry we wszystkich typach menu — w oknach, aplikacjach, ikonach zasobnika systemowego, ikonach Docka, menu kontekstowych i menu podręcznych.

Parametry

	`item:NativeMenuItem` — Obiekt NativeMenuItem do wstawienia.

	`index:int` — Pozycja w menu (oparta na zerze), do której należy wstawić pozycję menu. Uwaga: Dodanie elementu do menu może spowodować zawieszenie aplikacji, jeśli tym elementem będzie menu tożsame z menu nadrzędnym (tj. jeśli powstanie odwołanie cykliczne).

Zwraca

NativeMenuItem

Zgłasza

	`ArgumentError` — Jeżeli właściwość `item` ma wartość `null`.

	`ArgumentError` — Jeśli element `item` należy do innego menu.

	`RangeError` — Jeżeli indeks znajduje się poza granicami tablicy `items` menu.

addSubmenu

()

metoda

public function addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Dodaje podmenu do menu poprzez wstawienie nowej pozycji menu.

Wywołanie metody addSubMenu() jest równoważne utworzeniu nowej pozycji menu, dodaniu jej do menu oraz przypisaniu obiektu NativeMenu do właściwości submenu pozycji.

Uwaga: dodanie menu jako podmenu jego samego (utworzenie odniesienia cyklicznego) może spowodować zawieszenie aplikacji.

Parametry

	`submenu:NativeMenu` — Obiekt NativeMenu definiujący podmenu do dodania.

	`label:String` — Etykieta wyświetlania dla pozycji menu do dodania.

Zwraca

NativeMenuItem — Obiekt NativeMenuItem utworzony dla podmenu.

addSubmenuAt

()

metoda

public function addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Dodaje podmenu do menu poprzez wstawienie nowej pozycji menu na określonej pozycji.

Metoda addSubMenuAt() odpowiada utworzeniu nowej pozycji menu, wstawieniu jej do żądanej pozycji w menu oraz przypisaniu obiektu NativeMenu do właściwości submenu pozycji.

Uwaga: dodanie menu jako podmenu jego samego (utworzenie odniesienia cyklicznego) może spowodować zawieszenie aplikacji.

Parametry

	`submenu:NativeMenu` — Obiekt NativeMenu definiujący podmenu do dodania.

	`index:int` — Pozycja w tablicy `items` tego menu, na której należy wstawić pozycję menu do dodania

	`label:String` — Etykieta wyświetlania dla pozycji menu do dodania.

Zwraca

NativeMenuItem — Obiekt NativeMenuItem utworzony dla podmenu.

clone

()

metoda

public function clone():NativeMenu

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Tworzy kopię menu i wszystkich jego elementów.

Zwraca

NativeMenu

containsItem

()

metoda

public function containsItem(item:NativeMenuItem):Boolean

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Informuje, czy menu zawiera określoną pozycję.

Parametry

item:NativeMenuItem — Obiekt NativeMenuItem do wyszukania.

Zwraca

Boolean — Wartość true, jeżeli element item znajduje się w tym menu.

display

()

metoda

public function display(stage:Stage, stageX:Number, stageY:Number):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Wyświetla to menu w określonym miejscu.

Parametry

	`stage:Stage` — Obiekt Stage na którym ma być wyświetlone to menu.

	`stageX:Number` — Liczba poziomych pikseli względem źródła stołu montażowego, na którym ma być wyświetlane to menu.

	`stageY:Number` — Liczba pionowych pikseli względem źródła stołu montażowego, na którym ma być wyświetlane to menu.

getItemAt

()

metoda

public function getItemAt(index:int):NativeMenuItem

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Pobiera pozycję menu o podanym indeksie.

Parametry

index:int — Pozycja w menu (oparta na zerze) elementu do zwrócenia.

Zwraca

NativeMenuItem — Obiekt NativeMenuItem na określonej pozycji w menu.

Zgłasza

RangeError — Jeżeli właściwość index znajduje się poza granicami tablicy items menu.

getItemByName

()

metoda

public function getItemByName(name:String):NativeMenuItem

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Pobiera element menu o określonej nazwie.

Uwaga: Właściwość name elementu menu nie jest przypisywana domyślnie

Parametry

name:String — Ciąg znaków do wyszukania.

Zwraca

NativeMenuItem — Obiekt NativeMenuItem o określonej nazwie lub wartość null, jeżeli taki element nie istnieje w menu.

getItemIndex

()

metoda

public function getItemIndex(item:NativeMenuItem):int

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Pobiera położenie określonego elementu.

Parametry

item:NativeMenuItem — Obiekt NativeMenuItem do wyszukania.

Zwraca

int — Pozycja (liczona od zer) określonego elementu w tym menu lub wartość-1, jeżeli element nie znajduje się w tym menu.

removeAllItems

()

metoda

public function removeAllItems():void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Usuwa z menu wszystkie elementy.

removeItem

()

metoda

public function removeItem(item:NativeMenuItem):NativeMenuItem

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Usuwa określoną pozycję menu.

Parametry

item:NativeMenuItem — Obiekt NativeMenuItem przeznaczony do usunięcia z tego menu.

Zwraca

NativeMenuItem

Zgłasza

RangeError — Jeżeli element item nie znajduje się w tym menu.

removeItemAt

()

metoda

public function removeItemAt(index:int):NativeMenuItem

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Usuwa i zwraca pozycję menu o określonym indeksie.

Parametry

index:int — Pozycja (oparta na zerze) elementu do usunięcia.

Zwraca

NativeMenuItem — Usunięty obiekt NativeMenuItem.

Zgłasza

RangeError — Jeżeli właściwość index znajduje się poza granicami tablicy items menu.

setItemIndex

()

metoda

public function setItemIndex(item:NativeMenuItem, index:int):void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Przesuwa pozycję menu na określoną pozycję. Jeśli element nie znajduje się jeszcze w menu, wywołanie tej metody spowoduje dodanie go do menu.

Parametry

	`item:NativeMenuItem` — Obiekt NativeMenuItem do przesunięcia.

	`index:int` — Pozycja w menu (oparta na zerze), do której należy przesunąć element `item`.

Zgłasza

RangeError — Jeżeli właściwość index znajduje się poza granicami tablicy items menu.

Szczegół zdarzenia

displaying

Zdarzenie

Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.DISPLAYING

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Wywoływane przez ten obiekt NativeMenu tuż przed wyświetleniem menu.

Należy nasłuchiwać tego zdarzenia w celu aktualizacji menu tuż przed jego wyświetleniem. Zdarzenie displaying jest również wywoływane przez 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.

Uwaga: W systemie Mac OS X w środowisku AIR starszym niż wersja 2.6 naciśnięcie przez użytkownika odpowiednika klawisza powodowało wywołanie zdarzenia displaying. (W innych systemach operacyjnych to zdarzenie nie było wywoływane w odpowiedzi na użycie odpowiednika klawisza). W środowisku AIR 2.6 naciśnięcie przez użytkownika odpowiednika klawisza nie powoduje wywoływania zdarzeń displaying. Zamiast tego należy użyć zdarzenia preparing.

Stała 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

Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.PREPARING

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 2.6

Wywoływane przez obiekt NativeMenu, gdy zostaje naciśnięty odpowiednik klawisza, a także bezpośrednio przed wyświetleniem menu.

Należy wykrywać to zdarzenie w celu uaktualnienia menu przed wyświetleniem tego menu 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ć, dodawać lub usuwać elementy menu, a te zmiany będą obowiązywać podczas przetwarzania odpowiednika klawisza. Na przykład w przypadku usunięcia lub wyłączenia elementu menu przypisanego do wyzwalającego odpowiednika klawisza sekwencja zdarzeń zostaje efektywnie anulowana i nie jest wywoływane żadne zdarzenie select. Zdarzenie preparing jest również wywoływane przez 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.

Stała Event.PREPARING definiuje wartość właściwości type obiektu zdarzenia preparing.

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

Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.SELECT

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0

Wywoływane przez ten obiekt NativeMenu, gdy zostanie wybrana jedna z jego pozycji menu lub pozycja jednego z jego menu potomnych w porządku malejącym.

Zdarzenie select jest propagowane z elementu menu do menu zawierającego ten element i wzwyż wzdłuż łańcucha menu nadrzędnych do obiektu menu głównego. Właściwość target obiektu zdarzeń odwołuje się do wybranego obiektu NativeMenuItem, natomiast właściwość currentTarget odwołuje się do tego obiektu NativeMenu.

Stała 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.

Informacje prawne | Zasady prywatności online

NativeMenu - AS3

Pakietyx

Elementy językowe

Dodatki

Pakiet flash.display

isSupported

items

numItems

parent

NativeMenu

addItem

addItemAt

addSubmenu

addSubmenuAt

clone

containsItem

display

getItemAt

getItemByName

getItemIndex

removeAllItems

removeItem

removeItemAt

setItemIndex

displaying

preparing

select