FlexNativeMenu  - AS3 Flex

Объект-делегат, выполняющий обработку функций, связанных с автоматизацией.

Значение true, если этот компонент доступен для автоматизации; в противном случае – false.

Имя, которое можно использовать в качестве идентификатора этого объекта.

Владелец этого компонента в целях автоматизации.

Вышестоящий элемент этого компонента в целях автоматизации.

Реализация интерфейса IAutomationTabularData, который можно использовать для извлечения данных.

Это значение, как правило, соответствует отображению объекта и может быть удобным для соотнесения идентификатора с объектом, поскольку отображено в приложении.

Значение true, если этот компонент является видимым для автоматизации; в противном случае – false.

Объект, обеспечивающий доступ к данным и управление ими в поставщике данных. Элемент управления FlexNativeMenu выполняет делегирование в дескриптор данных для получения информации о его данных. Затем эти данные используются для анализа и перемещения источника данных. Дескриптор данных, определенный для FlexNativeMenu, используется во всех нижестоящих меню и подменю.

При указании этого свойства в качестве атрибута в MXML необходимо использовать ссылку на дескриптор данных, а не на имя строки дескриптора. Для установки свойства применяйте следующий формат:

<mx:FlexNativeMenu id="flexNativeMenu" dataDescriptor="{new MyCustomDataDescriptor()}"/>

В качестве альтернативы, в MXML свойство может быть указано в качестве вложенного подтега, как представлено в примере:

<mx:FlexNativeMenu>
      <mx:dataDescriptor>
         <myCustomDataDescriptor>
      </mx:dataDescriptor>
      ...

Значением по умолчанию является внутренний экземпляр класса DefaultDataDescriptor.

Иерархия объектов, используемых для определения структуры пунктов меню в NativeMenu. Отдельные объекты данных, определяющие элементы меню, и элементы с нижестоящими элементами становятся меню и подменю.

Обработка исходного объекта данных элементом управления FlexNativeMenu осуществляется следующим образом:

• Строка, содержащая допустимый текст XML, преобразуется в объект XML.
• XMLNode преобразуется в объект XML.
• XMLList преобразуется в XMLListCollection.
• Любой объект, реализующий интерфейс ICollectionView, приводится к ICollectionView.
• Массив преобразуется в ArrayCollection.
• Объект другого типа включается в массив, причем объект становится единственной записью.

Значением по умолчанию является "undefined".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие collectionChange .

Флаг, который указывает, что текущий поставщик данных имеет корневой узел; например, отдельный узел верхнего уровня в иерархической структуре. XML и Object являются примерами типов, которые имеют корневой узел, тогда как списки и массивы – нет.

Флаг, определяющий, прошел ли объект все три фазы создания макета: обязательство, измерение и создание макета (при условии, что все они требовались).

Имя поля в поставщике данных, определяющее эквивалентную клавишу для каждого элемента меню. Набор значений определяется в классе Keyboard, в константах KEYNAME_XXXX. Обратитесь к списку значений управляющего символа, например Home, Insert и т. д.

Установка свойства keyEquivalentFunction приведет к игнорированию данного свойства.

Значением по умолчанию является "keyEquivalent".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие keyEquivalentChanged .

Связанные элементы API

Функция, определяющая эквивалентные клавиши для каждого элемента меню. Если это свойство опускается, в программе Flex используется содержимое поля или атрибута, определенное при помощи свойства keyEquivalentField. При указании данного свойства игнорируются все значения свойства keyEquivalentField.

Свойство keyEquivalentFunction подходит для обработки форматирования, локализации и независимости платформы.

Функция эквивалента клавиши должна принимать отдельный аргумент, являющийся элементом поставщика данных, и возвращать строку.

myKeyEquivalentFunction(item:Object):String

Значением по умолчанию является "undefined".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие keyEquivalentFunctionChanged .

Связанные элементы API

Функция, определяющая модификаторы эквивалентных клавиш для каждого пункта меню. Если это свойство опускается, в программе Flex применяется собственная функция по умолчанию, позволяющая определить массив модификаторов путем поиска данных в поставщике данных со следующими (логическими) полями: altKey, commandKey, controlKey и shiftKey.

Свойство keyEquivalentModifiersFunction подходит для обработки форматирования, локализации и независимости платформы.

Функция модификаторов эквивалентных клавиш должна принимать отдельный аргумент, являющийся элементом поставщика данных, и возвращать массив имен модифицирующих клавиш.

myKeyEquivalentModifiersFunction(item:Object):Array

Значением по умолчанию является "undefined".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие keyEquivalentModifiersFunctionChanged .

Имя поля в поставщике данных, определяющего текст, который должен отображаться для каждого элемента меню. Если поставщиком данных является массив строк, каждое строковое значение используется в качестве метки. Если поставщиком данных является объект XML E4X, необходимо явным образом установить это свойство. Например, если каждый элемент XML объекта XML E4X включает атрибут «метка», содержащий текст, который должен отображаться для каждого элемента меню, установите значение @label для свойства labelField.

Для указания символа, который должен использоваться в качестве мнемонического индекса, в метке необходимо добавить знак подчеркивания перед ним. Например, значение метки C_ut устанавливает мнемонический индекс 1. С этой целью используется только первый символ подчеркивания. Для отображения точного символа подчеркивания в метке этого можно избежать путем установки двойного подчеркивания. Например, установка значения метки C__u_t приведет к созданию пункта меню с меткой C_ut и мнемоническим индексом 3 (символ t). Если поле, определенное в свойстве mnemonicIndexField, существует и имеет значение, отличное от нуля, это значение имеет приоритет над любым значением мнемонического индекса, указанного с помощью знаков подчеркивания.

Установка свойства labelFunction приводит к игнорированию этого свойства.

Значением по умолчанию является "label".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие labelFieldChanged .

Функция, определяющая текст, который должен отображаться для каждого пункта меню. Функция метки должна обеспечивать поиск соответствующего поля или полей в поставщике данных и возвращение отображаемой строки.

Если это свойство опускается, в программе Flex применяется содержимое поля или атрибута, определенное с помощью свойства labelField. Установка данного свойства приводит к игнорированию любого значения свойства labelField.

Свойство labelFunction может быть полезным при обработке форматирования, локализации и автономности платформы.

Функция метки должна принимать отдельный аргумент, являющийся элементом поставщика данных, и возвращать строку.

myLabelFunction(item:Object):String

Значением по умолчанию является "undefined".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие labelFunctionChanged .

Имя поля в поставщике данных, определяющее мнемонический индекс для каждого пункта меню.

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

Установка свойства mnemonicIndexFunction приводит к игнорированию этого свойства.

Значением по умолчанию является "mnemonicIndex".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие mnemonicIndexChanged .

Связанные элементы API

Функция, определяющая мнемонический индекс для каждого элемента меню.

Если это свойство опускается, в программе Flex используется содержимое поля или атрибута, указанного в свойстве mnemonicIndexField. Указание этого свойства приводит к игнорированию любого значения свойства mnemonicIndexField.

Если это свойство определено и для элемента данных функция возвращает положительное число, возвращаемый мнемонический индекс имеет приоритет над любым индексом, определенным с помощью подчеркивания в метке.

Свойство mnemonicIndexFunction подходит для обработки форматирования, локализации и независимости платформы.

Функция мнемонического индекса должна принимать отдельный аргумент, являющийся элементом поставщика данных, и возвращать целое число.

myMnemonicIndexFunction(item:Object):int

Значением по умолчанию является "undefined".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие mnemonicIndexFunctionChanged .

Возвращает элемент flash.display.NativeMenu, управляемый этим объектом, или null, если такой элемент отсутствует. Любые изменения, вносимые непосредственно в экземпляр NativeMenu, могут быть потеряны при внесении изменений в меню или основного поставщика данных.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие nativeMenuUpdate .

Глубина этого объекта в иерархии включения. Это число используется кодом макета и измерения. Значение – 0, если этот компонент не находится в DisplayList.

Число нижестоящих элементов автоматизации, содержащихся в этом контейнере. Эта сумма не должна включать составных нижестоящих элементов, хотя включает нижестоящие элементы, незначительные в иерархии автоматизации.

Установлено на true после немедленного или отложенного создания нижестоящих элементов в зависимости от выполняемого действия. Для контейнерного объекта значение устанавливается на true в конце метода createComponentsFromDescriptors(), что предполагает, что контейнерный объект создает нижестоящие записи из собственных нижестоящих дескрипторов.

Например, если контейнер Accordion использует отложенную реализацию, свойство processedDescriptors для второй панели контейнера Accordion не приобретает значение true до перехода пользователя к этой панели и создания нижестоящих элементов самой панелью. Однако если контейнером Accordion установлено свойство creationPolicy на all, свойство processedDescriptors для второй панели устанавливается на true в течение запуска приложения.

Для классов, которые не являются контейнерами, не имеющими дескрипторы, свойство устанавливается на true после того, как метод createChildren() создаст любые внутренние нижестоящие элементы компонента.

Флаг, который определяет, показан ли объект автоматизации в иерархии автоматизации. Нижестоящие элементы невидимых в иерархии контейнеров отображаются в качестве нижестоящих элементов следующего вышестоящего элемента. Обычно используемые для макета контейнеры, например поля и Canvas, не отображаются в иерархии.

Некоторые элементы управления при необходимости вызывают принудительное отображение нижестоящих элементов в иерархии. Например, для List в иерархии всегда будут принудительно отображаться средства визуализации элементов, в т.ч. поля. При реализации должно поддерживаться значение true этого свойства.

Логический флаг, указывающий, отобразить ли корневой узел поставщика данных.

Если поставщик данных имеет корневой узел и свойство showRoot имеет значение false, элементы меню верхнего уровня, отображаемые при помощи элемента управления FlexNativeMenu, соответствуют непосредственным нижестоящим элементам корневого узла.

Этот флаг не влияет на источник без корневого узла, например на объекты списка или массива.

Значением по умолчанию является true.

Связанные элементы API

Флаг, определяющий, прошел ли объект все три фазы проверки макета (при условии, что все они требовались).

Конструктор.

Обрабатывает свойства, установленные в компоненте.

Связанные элементы API

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

Параметры

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

Параметры

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

Параметры

Предоставляет объект автоматизации с указанным индексом. В этом списке не должно быть составных нижестоящих элементов.

Параметры

Обеспечивает список объектов автоматизации. В этом списке отсутствуют составные нижестоящие элементы.

Отмечает компонент с целью вызова его метода commitProperties() во время последующего обновления экрана.

Механизм недействительности позволяет исключить дублирование операций за счет задержки обработки изменений компонента до момента последующего обновления экрана. Например, при необходимости изменения цвета и размера текста нерационально обновлять цвет сразу после его изменения, а затем выполнять обновление размера после его установки. Более эффективным подходом является изменение обоих свойств с последующим выполнением визуализации текста с учетом изменений размера и текста.

Методы недействительности вызываются достаточно редко. Как правило, при установке свойств компонента задается автоматическое выполнение вызова соответствующего метода недействительности.

Возвращает эквивалентную клавишу для заданного объекта данных на основе свойств keyEquivalentField и keyEquivalentFunction. Если методу не удается преобразовать параметр в строку, возвращается пустая строка.

Параметры

Возвращает модификаторы эквивалентных клавиш для заданного объекта данных на основе свойства keyEquivalentModifiersFunction. Если с помощью метода не удается преобразовать параметр в массив модификаторов, возвращается пустой массив.

Параметры

Возвращает строку, которая должна использоваться в качестве метки элемента меню для заданного объекта данных на основе свойств labelField и labelFunction. Если методу не удается преобразовать параметр в строку, возвращается одиночный знак пробела.

Параметры

Возвращает мнемонический индекс для заданного объекта данных на основе свойств mnemonicIndexField и mnemonicIndexFunction. Если с помощью метода не удается преобразовать параметр в целое число, возвращается значение -1.

Параметры

Обеспечивает извлечение мнемонического индекса из метки на основе наличия символа подчеркивания. Обеспечивает нахождение первого символа подчеркивания, если таковой существует, и его использование в качестве индекса.

Параметры

Определяет фактическую метку, которая должна использоваться для элемента NativeMenuItem путем удаления символов подчеркивания и преобразования уцелевших символов подчеркивания, если таковые существуют.

Параметры

Воспроизводит указанное событие. Автор компонента должен вызвать super.replayAutomatableEvent в случае, если поведение воспроизведения по умолчанию определено в суперклассе.

Параметры

Определяет нижестоящий элемент с помощью предоставленного идентификатора. Этот идентификатор представляет собой набор свойств, предоставляемых методом createAutomationIDPart().

Параметры

Устанавливает контекстное меню элемента InteractiveObject для основного собственного меню.

Параметры

Обеспечивает сброс контекстного меню элемента InteractiveObject, установленного для основного собственного меню.

Параметры

Проверяет правильность расположения и размера нижестоящих элементов и отображает различные визуальные эффекты. Если совместно с ILayoutManagerClient вызван метод LayoutManager.invalidateDisplayList(), то при обновлении списка отображения будет вызван методvalidateDisplayList().

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

Проверяет правильность свойств компонента. Если с данным IlayoutManagerClient вызван метод LayoutManager.invalidateProperties(), то при отправке значений свойств будет вызван методvalidateProperties().

Проверяет правильность измеренного размера компонента. Если совместно с данным IlayoutManagerClient вызван метод LayoutManager.invalidateSize(), то при измерении будет вызван метод validateSize().

Параметры

Передается при выборе пункта меню.

Свойства объекта события для этого типа события имеют следующие значения. Не все свойства являются значимыми для каждого из видов событий. Дополнительную информацию см. в подробных описаниях свойств.

Передается перед отображением меню или подменю.

Свойства объекта события для этого типа события имеют следующие значения. Не все свойства являются значимыми для каждого из видов событий. Дополнительную информацию см. в подробных описаниях свойств.