| Пакет | flash.display |
| Класс | public class NativeMenuItem |
| Наследование | NativeMenuItem  EventDispatcher Object |
| Подклассы | ContextMenuItem |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Элементом меню может быть команда, подменю или разделительная линия.
- Чтобы создать элемент команды, вызовите конструктор NativeMenuItem, передайте строку для ярлыка и значение
falseдля параметраisSeparator. - Чтобы создать подменю, создайте элемент команды для родительского меню и назначьте объект подменю NativeMenu свойству элемента
submenu. Также можно создать методaddSubmenu()родительского объекта NativeMenu, чтобы создать элемент и одновременно задать свойствоsubmenu. - Чтобы создать разделитель, вызовите конструктор NativeMenuItem, передайте пустую строку для подписи и значение
trueдля параметраisSeparator.
Прослушивайте события select для элемента или родительского меню, чтобы узнать, когда будет выбрана команда меню. Ни подменю, ни разделители не передают события select Прослушивайте события preparing, чтобы определить, когда элемент меню будет показан или активирован с помощью эквивалентной комбинации клавиш.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| checked : Boolean
Управляет отображением флажка для данного элемента меню. | NativeMenuItem | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| data : Object
Объект произвольных данных, связанный с данным элементом меню. | NativeMenuItem | ||
| enabled : Boolean
Управляет включением данного элемента меню. | NativeMenuItem | ||
| isSeparator : Boolean [только для чтения]
Сообщает, является ли данный элемент разделительной линией меню. | NativeMenuItem | ||
| keyEquivalent : String
Эквивалентная комбинация клавиш для данного элемента меню. | NativeMenuItem | ||
| keyEquivalentModifiers : Array
Массив кодов клавиш для модификаторов эквивалентной комбинации клавиш. | NativeMenuItem | ||
| label : String
Строка отображения данного элемента меню. | NativeMenuItem | ||
| menu : NativeMenu [только для чтения]
Меню, содержащее данный элемент. | NativeMenuItem | ||
| mnemonicIndex : int
Положение мнемонического символа в ярлыке элемента меню. | NativeMenuItem | ||
| name : String
Имя данного элемента меню. | NativeMenuItem | ||
| submenu : NativeMenu
Подменю, связанное с данным элементом меню. | NativeMenuItem | ||
| Метод | Определено | ||
|---|---|---|---|
Создает новый объект NativeMenuItem. | NativeMenuItem | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
Создает копию объекта NativeMenuItem. | NativeMenuItem | ||
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает строку, содержащую все свойства объекта NativeMenuItem. | NativeMenuItem | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Событие | Сводка | Определено | ||
|---|---|---|---|---|
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным. | EventDispatcher | ||
| [многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным. | EventDispatcher | ||
| Передается этим объектом NativeMenuItem непосредственно перед показом меню, содержащего элемент. | NativeMenuItem | |||
| Отправляется этим объектом NativeMenuItem при нажатии его эквивалентной комбинации клавиш и непосредственно перед отображением содержащего его меню. | NativeMenuItem | |||
| Передается каждый раз, когда пользователь выбирает элемент меню. | NativeMenuItem | |||
checked | свойство |
data | свойство |
data:Object| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Объект произвольных данных, связанный с данным элементом меню.
Этому свойству можно назначить любой объект. Назначенный объект не используется системой меню, но доступен для кода обработки события (через свойство target объекта событий). По умолчанию в качестве значения этого свойства выбраноnull
Реализация
public function get data():Object public function set data(value:Object):void enabled | свойство |
isSeparator | свойство |
isSeparator:Boolean [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Сообщает, является ли данный элемент разделительной линией меню.
Создайте разделительную линию, задав для параметра isSeparator в конструкторе NativeMenuItem значение true.
Реализация
public function get isSeparator():Boolean keyEquivalent | свойство |
keyEquivalent:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Эквивалентная комбинация клавиш для данного элемента меню.
Задайте keyEquivalent, используя строчную букву, чтобы назначить комбинацию клавиш без модификатора клавиши Shift. Задайте заглавную букву, чтобы назначить комбинацию клавиш с использованием модификатора клавиши Shift.
По умолчанию в комбинацию клавиш включается модификатор эквивалентной комбинации клавиш (Ctrl для Windows или Linux и Command для Mac OS X). Если в эквивалентную комбинацию клавиш не должны входить модификаторы, установите свойство keyEquivalentModifiers на пустой массив.
Реализация
public function get keyEquivalent():String public function set keyEquivalent(value:String):void keyEquivalentModifiers | свойство |
keyEquivalentModifiers:Array| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Массив кодов клавиш для модификаторов эквивалентной комбинации клавиш.
Используйте константы, определенные в классе Keyboard, чтобы указать коды клавиш для модификаторов. Допускаются следующие клавиши-модификаторы:
Keyboard.ALTERNATEKeyboard.COMMANDKeyboard.CONTROL
Если не назначено других модификаторов, по умолчанию в Windows или Linux указывается клавиша Keyboard.CONTROL, а в Mac OS X — Keyboard.COMMAND. Если эти модификаторы не должны входить в эквивалентную комбинацию клавиш, установите это свойство на пустой массив.
Если свойству keyEquivalent назначается заглавная буква, то в качестве модификатора автоматически используется клавиша Shift. Назначение свойству keyEquivalentModifier пустого массива не приведет к отмене использования модификатора Shift.
Реализация
public function get keyEquivalentModifiers():Array public function set keyEquivalentModifiers(value:Array):voidСвязанные элементы API
label | свойство |
menu | свойство |
menu:NativeMenu [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Меню, содержащее данный элемент.
Реализация
public function get menu():NativeMenu mnemonicIndex | свойство |
mnemonicIndex:int| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Положение мнемонического символа в ярлыке элемента меню.
Символ в указанном положении является мнемоническим для элемента меню. Индекс строится с нуля, поэтому первый символ имеет индекс 0.
Данное свойство игнорируется в операционных системах, не использующих мнемосхемы меню.
Реализация
public function get mnemonicIndex():int public function set mnemonicIndex(value:int):void name | свойство |
name:String| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Имя данного элемента меню.
Значение имени не отображается, его можно использовать в качестве идентификатора, независимого от локали. Имя не назначается автоматически.
Реализация
public function get name():String public function set name(value:String):void submenu | свойство |
submenu:NativeMenu| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Подменю, связанное с данным элементом меню.
Назначение объекта NativeMenu данному свойству изменяет вид и поведение элемента меню. Элемент подменю отображает значок подменю и перестает передавать события select.
Примечание. Добавление меню в качестве подменю для самого себя (по циклической ссылке) может привести к зависанию приложения.
Реализация
public function get submenu():NativeMenu public function set submenu(value:NativeMenu):voidСвязанные элементы API
NativeMenuItem | () | Конструктор |
public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Создает новый объект NativeMenuItem.
Чтобы создать команду меню, задайте параметр label строке, содержащей экранную подпись, а для isSeparator укажите значение false.
Чтобы создать команду подменю, создайте элемент команды, а затем назначьте объект подменю NativeMenu свойству элемента submenu. Добавьте элемент в родительское меню.
Чтобы создать разделитель, задайте параметр label пустой строке, а для isSeparator укажите значение true.
Добавляйте и удаляйте элементы из меню с помощью методов NativeMenu addItem() и removeItem().
label:String (default = " | |
isSeparator:Boolean (default = false)true, чтобы создать разделитель; в противном случае задайте false.
|
Связанные элементы API
clone | () | метод |
public function clone():NativeMenuItem| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Создает копию объекта NativeMenuItem.
ВозвращаетNativeMenuItem |
toString | () | метод |
displaying | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.DISPLAYING| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Передается этим объектом NativeMenuItem непосредственно перед показом меню, содержащего элемент.
Событие preparing предшествует событию displaying и предоставляет дополнительную функциональность. Прослушивайте только одно из событий: preparing или displaying.
Event.DISPLAYING определяет значение свойства type объекта события displaying.
Примечание. Это событие не проходит фазу захвата и отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, который сейчас будет отображаться. |
preparing | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.PREPARING| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 2.6 |
Отправляется этим объектом NativeMenuItem при нажатии его эквивалентной комбинации клавиш и непосредственно перед отображением содержащего его меню.
Прослушивайте это событие, чтобы обновить элемент перед отображением содержащего его меню или когда пользователь нажимает его эквивалентную комбинацию клавиш. Событие preparing отправляется прежде, чем будет завершена оценка эквивалентной комбинации клавиш. Можно включить, отключить или удалить элемент из меню с помощью обработчика события preparing, и эти изменения вступят в силу при нажатии эквивалентной комбинации клавиш. Например, при удалении или отключении этого элемента меню последовательность событий отменяется, и событие select не отправляется. Событие preparing также отправляется другими элементами меню.
Событие preparing предшествует событию displaying и предоставляет дополнительную функциональность. Прослушивайте только одно из событий: preparing или displaying.
Event.PREPARING определяет значение свойства type объекта события preparing.
Примечание. Это событие не проходит фазу захвата и отправляется непосредственно целевому элементу независимо от того, находится он в списке отображения или нет.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Объект, отправивший это событие. |
target | Объект, отправивший это событие. |
select | Событие |
flash.events.Eventсвойство Event.type =
flash.events.Event.SELECT| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Передается каждый раз, когда пользователь выбирает элемент меню.
Событие select переходит по восходящей цепочке из данного элемента в содержащее его меню и дальше вверх к корневому объекту меню. Свойство target объекта события ссылается на данный объект NativeMenuItem, а свойство currentTarget ссылается на передающий объект (либо данный объект NativeMenuItem, либо предшествующий ему NativeMenu).
Примечание. Если окно, содержащее меню, показывается в полноэкранном режиме (stage.displayState == StageDisplayState.FULL_SCREEN), то объект NativeMenuItem не передает событие select, когда пользователь вводит комбинацию клавиш, эквивалентную элементу меню.
Event.SELECT определяет значение свойства type объекта события select.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
target | Объект, в котором выделен элемент. |
Tue Jun 12 2018, 11:34 AM Z