Главная / Action Script 3
(Только AIR)
Пакетflash.display
Классpublic class NativeMenu
НаследованиеNativeMenu Inheritance EventDispatcher Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Класс NativeMenu содержит методы и свойства для определения меню.

AIR поддерживает следующие типы меню:

МенюЭкземплярТест возможностейПоддерживается наЗначения по умолчанию?
Приложение NativeApplication.nativeApplication.menu NativeApplication.supportsMenu Mac OS XДа
Окно NativeWindow.menu NativeWindow.supportsMenu WindowsНет
Значок панели NativeApplication.nativeApplication.icon.menu NativeApplication.supportsDockIcon Mac OS XДа
Значок на панели задач NativeApplication.nativeApplication.icon.menu NativeApplication.supportsSystemTrayIcon WindowsНет
Контекст InteractiveObject.contextMenu Всегда поддерживаетсяВсеНет
Раскрывающееся менюЛюбой экземпляр NativeMenuВсегда поддерживаетсяВсеНет

Меню может содержать элементы для команд, подменю и разделительных линий. Элементы меню добавляются с помощью методов addItem(), addItemAt(), addSubmenu() и addSubmenuAt(). Порядок отображения элементов меню соответствует порядку элементов в массиве items меню.

Подменю присоединяются к родительскому меню через свойство submenu соответствующего элемента в родительском меню. Корневое меню окна и меню приложений должны содержать только элементы подменю. Элементы без подменю не показываются, так как они противоречат ожиданиям пользователей от меню такого типа.

Меню отправляют события select, когда в меню или подменю выбирается элемент команды. (Подменю и разделители выбрать нельзя.) Свойство target объекта события ссылается на выбранный элемент.

Меню отправляют события displaying непосредственно перед отображением меню. Это событие можно использовать для обновления содержимого меню на основе текущего состояния приложения.

Примечание. Для настройки контекстного меню можно использовать как объект NativeMenu, так и объект ContextMenu. Проигрыватель Flash Player поддерживает только класс ContextMenu class, а класс NativeMenu — нет.

См. также

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


Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  AIR-only items : Array
Массив объектов NativeMenuItem в данном меню.
NativeMenu
  AIR-only numItems : int
[только для чтения] Количество объектов NativeMenuItem в данном меню.
NativeMenu
  AIR-only parent : NativeMenu
[только для чтения] Родительское меню.
NativeMenu
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
Общедоступные методы
 МетодОпределено
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события в объекте EventDispatcher, в результате чего прослушиватель будет получать уведомления о событиях.
EventDispatcher
  
Добавляет элемент в конец меню.
NativeMenu
  
Вставляет элемент меню в указанное положение.
NativeMenu
  
Добавляет подменю в меню путем вставки нового элемента меню.
NativeMenu
  
Добавляет подменю в меню, вставляя новый элемент меню в заданное положение.
NativeMenu
  
Создает копию меню и всех элементов.
NativeMenu
  
Сообщает, содержит ли меню указанный элемент.
NativeMenu
 Inherited
Передает событие в поток событий.
EventDispatcher
  
AIR-only display(stage:Stage, stageX:Number, stageY:Number):void
Добавляет раскрывающееся меню в заданном положении.
NativeMenu
  
Определяет элемент меню, расположенный по заданному индексу.
NativeMenu
  
Определяет элемент меню с заданным именем.
NativeMenu
  
Определяет положение заданного элемента.
NativeMenu
 Inherited
Проверяет наличие у объекта EventDispatcher прослушивателей событий, которые зарегистрированы для получения уведомлений о событиях определенного типа.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
  
Удаляет все пункты меню.
NativeMenu
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
Удаляет заданный элемент меню.
NativeMenu
  
Удаляет и возвращает элемент меню в заданный индекс.
NativeMenu
  
Перемещает элемент меню в заданное положение.
NativeMenu
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель событий в объекте EventDispatcher или в любом из его предков для получения уведомлений о событиях определенного типа.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player покидает фокус операционной системы и становится неактивным.EventDispatcher
  Отправляется этим объектом NativeMenu object непосредственно перед показом меню.NativeMenu
  Отправляется этим объектом NativeMenu при выборе одного из элементов меню или элемента одного из подменю.NativeMenu
Сведения о свойстве
AIR-only itemsсвойство
items:Array  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Массив объектов NativeMenuItem в данном меню.

Массив сортируется в порядке отображения.



Реализация
    public function get items():Array
    public function set items(value:Array):void
AIR-only numItemsсвойство 
numItems:int  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Количество объектов NativeMenuItem в данном меню.



Реализация
    public function get numItems():int
AIR-only parentсвойство 
parent:NativeMenu  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Родительское меню.

Родителем корневого объекта меню (верхнего уровня) является null.



Реализация
    public function get parent():NativeMenu
Сведения о методе
AIR-only addItem()метод
public function addItem(item:NativeMenuItem):NativeMenuItem

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Добавляет элемент в конец меню.

Параметры

item:NativeMenuItem — Объект NativeMenuItem для добавления в конец меню.

Возвращает
NativeMenuItem
AIR-only addItemAt()метод 
public function addItemAt(item:NativeMenuItem, index:int):NativeMenuItem

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Вставляет элемент меню в указанное положение.

Параметры

item:NativeMenuItem — Вставляемый объект NativeMenuItem.
 
index:int — Положение в меню (от нуля), выбранная для вставки элемента меню.

Возвращает
NativeMenuItem

Выдает
ArgumentError — Если item имеет значение null.
 
RangeError — Если индекс находится за пределами массива items меню.
AIR-only addSubmenu()метод 
public function addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem

Версии среды выполнения:  1.0

Добавляет подменю в меню путем вставки нового элемента меню.

Вызов метода addSubMenu() равносилен созданию нового элемента меню, его добавлению в меню и назначению объекта NativeMenu свойству submenu элемента.

Параметры

submenu:NativeMenu — Объект NativeMenu, определяющий добавляемое подменю.
 
label:String — Ярлык отображения для добавляемого элемента меню.

Возвращает
NativeMenuItem — Объект NativeMenuItem, созданный для подменю.
AIR-only addSubmenuAt()метод 
public function addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem

Версии среды выполнения:  1.0

Добавляет подменю в меню, вставляя новый элемент меню в заданное положение.

Вызов метода addSubMenuAt() равносилен созданию нового элемента меню, вставке его в желаемое положение в меню и назначению объекта NativeMenu свойству submenu элемента.

Параметры

submenu:NativeMenu — Объект NativeMenu, определяющий добавляемое подменю.
 
index:int — Позиция массива items данного меню, в которую требуется вставить добавляемый элемент меню.
 
label:String — Ярлык отображения для добавляемого элемента меню.

Возвращает
NativeMenuItem — Объект NativeMenuItem, созданный для подменю.
AIR-only clone()метод 
public function clone():NativeMenu

Версии среды выполнения:  1.0

Создает копию меню и всех элементов.

Возвращает
NativeMenu
AIR-only containsItem()метод 
public function containsItem(item:NativeMenuItem):Boolean

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Сообщает, содержит ли меню указанный элемент.

Параметры

item:NativeMenuItem — Объект NativeMenuItem, который требуется найти.

Возвращает
Booleantrue, если элемент есть в этом меню.
AIR-only display()метод 
public function display(stage:Stage, stageX:Number, stageY:Number):void

Версии среды выполнения:  1.0

Добавляет раскрывающееся меню в заданном положении.

Параметры

stage:Stage — Объект Stage, на котором будет отображаться данное меню.
 
stageX:Number — Число пикселов по горизонтали относительно начала рабочей области, на котором будет отображаться данное меню.
 
stageY:Number — Число пикселов по вертикали относительно начала рабочей области, на котором будет отображаться данное меню.

AIR-only getItemAt()метод 
public function getItemAt(index:int):NativeMenuItem

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Определяет элемент меню, расположенный по заданному индексу.

Параметры

index:int — Положение (от нуля) возвращаемого элемента.

Возвращает
NativeMenuItem — Объект NativeMenuItem, расположенный в заданном положении в меню.

Выдает
RangeError — Если индекс находится за пределами массива items меню.
AIR-only getItemByName()метод 
public function getItemByName(name:String):NativeMenuItem

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Определяет элемент меню с заданным именем.

Примечание. Свойство name элементов меню не назначается по умолчанию.

Параметры

name:String — Искомая строка.

Возвращает
NativeMenuItem — Объект NativeMenuItem с заданным именем или null, если такого элемента в меню не существует.
AIR-only getItemIndex()метод 
public function getItemIndex(item:NativeMenuItem):int

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Определяет положение заданного элемента.

Параметры

item:NativeMenuItem — Объект NativeMenuItem, который требуется найти.

Возвращает
int — Положение (от нуля) заданного элемента в данном меню или null, если элемента нет в меню.
AIR-only removeAllItems()метод 
public function removeAllItems():void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Удаляет все пункты меню.

AIR-only removeItem()метод 
public function removeItem(item:NativeMenuItem):NativeMenuItem

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Удаляет заданный элемент меню.

Параметры

item:NativeMenuItem — Объект NativeMenuItem для удаления из данного меню.

Возвращает
NativeMenuItem

Выдает
RangeError — Если элемента нет в этом меню.
AIR-only removeItemAt()метод 
public function removeItemAt(index:int):NativeMenuItem

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Удаляет и возвращает элемент меню в заданный индекс.

Параметры

index:int — Положение (от нуля) удаляемого элемента.

Возвращает
NativeMenuItem — Удаленный объект NativeMenuItem.

Выдает
RangeError — Если индекс находится за пределами массива items этого меню.
AIR-only setItemIndex()метод 
public function setItemIndex(item:NativeMenuItem, index:int):void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0

Перемещает элемент меню в заданное положение.

Параметры

item:NativeMenuItem — Перемещаемый объект NativeMenuItem.
 
index:int — Положение (от нуля) в меню, в которую нужно переместить элемент.


Выдает
RangeError — Если индекс находится за пределами массива items меню.
Сведения о событии
AIR-only displaying Событие
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.DISPLAYING

Версии среды выполнения:  1.0

Отправляется этим объектом NativeMenu object непосредственно перед показом меню.

Прослушивайте это событие для обновления меню перед показом. События Displaying также отправляются элементами в меню.

Задает значение свойства type объекта события displaying.

Примечание. Это событие не проходит фазу захвата и отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, который сейчас будет отображаться.
AIR-only select Событие  
Тип объекта события: flash.events.Event
свойство Event.type = flash.events.Event.SELECT

Версии среды выполнения:  1.0

Отправляется этим объектом NativeMenu при выборе одного из элементов меню или элемента одного из подменю.

Событие select переходит по восходящей цепочке из данного элемента в содержащее его меню и дальше вверх к корневому объекту меню. Свойство target объекта событий ссылается на выбранный объект NativeMenuItem. Свойство currentTarget ссылается на данный объект NativeMenu.

Константа Event.SELECT определяет значение свойства type объекта события select.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
targetОбъект, в котором выделен элемент.