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。
• 将 Array 转换为 ArrayCollection。
• 将任何其它类型的对象作为 Array 的唯一条目纳入该 Array 中。

默认值为 "undefined"。

此属性可用作数据绑定的源。修改此属性后，将调度 collectionChange 事件。

一个标志，用于指明当前数据提供程序具有根节点；例如，层次结构中的单个顶级节点。XML 和 Object 就是有根节点的类型的示例，而 List 和 Array 不是。

一个标志，用于确定某个对象是否已通过布局的所有三个阶段：提交、测量和布局（假设每个阶段都是必需的）。

数据提供程序中的字段名称，用以确定每个菜单项的等效键。采用的一系列值在 Keyboard 类中以 KEYNAME_XXXX 常量定义。例如，查阅该列表了解控制字符（如 Home、Insert 等）的值。

设置 keyEquivalentFunction 属性将导致此属性被忽略。

默认值为 "keyEquivalent"。

此属性可用作数据绑定的源。修改此属性后，将调度 keyEquivalentChanged 事件。

相关 API 元素

确定每个菜单项等效键的函数。如果省略此属性，则 Flex 将使用 keyEquivalentField 属性指定的字段或属性的内容。如果指定了此属性，则 Flex 将忽略任何 keyEquivalentField 属性值。

keyEquivalentFunction 属性适用于处理格式化、本地化和平台独立性。

等效功能键函数必须采用一个参数，该参数是数据提供程序中的项目，并且必须返回一个字符串。

myKeyEquivalentFunction(item:Object):String

默认值为 "undefined"。

此属性可用作数据绑定的源。修改此属性后，将调度 keyEquivalentFunctionChanged 事件。

相关 API 元素

确定每个菜单项的等效功能键的函数。如果省略此属性，则 Flex 将使用其自身默认的函数来确定功能键的 Array，具体方法是在数据提供者数据中确定是否存在以下（布尔型）字段：altKey、commandKey、controlKey 和 shiftKey。

keyEquivalentModifiersFunction 属性适用于处理格式化、本地化和平台独立性。

等效功能键函数必须采用一个参数，该参数是数据提供程序中的项目，并且必须返回一个功能键名称数组。

myKeyEquivalentModifiersFunction(item:Object):Array

默认值为 "undefined"。

此属性可用作数据绑定的源。修改此属性后，将调度 keyEquivalentModifiersFunctionChanged 事件。

数据提供程序中的字段名称，用以确定每个菜单项的显示文本。如果数据提供程序是一个字符串 Array，则 Flex 会将每个字符串值作为标签使用。如果数据提供程序是一个 E4X XML 对象，则必须显式设置此属性。例如，如果 E4X XML 对象中的每个 XML 元素都包含一个“label”属性，其中包含每个菜单项的显示文本，则请将 labelField 设置为 "@label"。

在标签中，您可以通过在字符前添加下划线指定将该字符用作助记键索引。例如，"C_ut" 标签值将助记键索引设置为 1。只有显示的第一个下划线具有此功能。若要在标签中显示文字下划线字符，您可以使用一条双下划线对其进行转义。例如，"C__u_t" 标签值可能会生成标签为“C_ut”、助记键索引为 3（“t”字符）的菜单项。如果存在由 mnemonicIndexField 属性定义的字段，并且设置为大于零的值，则此值将优先于任何用下划线指定的助记键索引值。

设置 labelFunction 属性将导致此属性被忽略。

默认值为 "label"。

此属性可用作数据绑定的源。修改此属性后，将调度 labelFieldChanged 事件。

用于确定每个菜单项的显示文本的函数。标签函数必须在数据提供程序中查找一个或多个相应的字段，并返回一个可显示的字符串。

如果省略此属性，Flex 将使用 labelField 属性指定的字段或属性的内容。如果指定了此属性，则 Flex 将忽略任何 labelField 属性值。

labelFunction 属性有助于处理格式化、本地化和平台独立性。

标签函数必须采用一个参数，该参数是数据提供程序中的项目，并且必须返回一个字符串。

myLabelFunction(item:Object):String

默认值为 "undefined"。

此属性可用作数据绑定的源。修改此属性后，将调度 labelFunctionChanged 事件。

数据提供程序中的字段名称，用以确定每个菜单项的助记键索引。

如果此属性指定的字段中包含大于零的数值，则助记键索引将优先于标签中用下划线指定的索引。

设置 mnemonicIndexFunction 属性将导致此属性被忽略。

默认值为 "mnemonicIndex"。

此属性可用作数据绑定的源。修改此属性后，将调度 mnemonicIndexChanged 事件。

相关 API 元素

确定每个菜单项的助记键索引的函数。

如果省略此属性，Flex 将使用 mnemonicIndexField 属性指定的字段或属性的内容。如果指定了此属性，则 Flex 将忽略任何 mnemonicIndexField 属性值。

如果已定义此属性，并且该函数针对数据项目返回大于零的数值，则返回的助记键索引将优先于标签中用下划线指定的索引。

mnemonicIndexFunction 属性适用于处理格式化、本地化和平台独立性。

助记键索引函数必须采用一个参数，该参数是数据提供程序中的项目，并且必须返回一个常量。

myMnemonicIndexFunction(item:Object):int

默认值为 "undefined"。

此属性可用作数据绑定的源。修改此属性后，将调度 mnemonicIndexFunctionChanged 事件。

返回由此对象管理的 flash.display.NativeMenu；如果不存在，则返回 null。如果更改菜单或基础数据提供程序，则可能会丢失直接对基础 NativeMenu 实例所做的任何更改。

此属性可用作数据绑定的源。修改此属性后，将调度 nativeMenuUpdate 事件。

此对象在所属关系层次结构中的深度。测量和布局代码都使用此编号。如果 DisplayList 中没有此组件，则值为 0。

此容器包含的自动化子项数。此和不应包含任何复合子项，尽管它在自动化层次中确实包含这些不重要的子项。

临时或延迟子项创建操作后设置为 true，具体取决于发生对象。对于 Container 对象，在 createComponentsFromDescriptors() 方法结束（即 Container 对象使用其子项描述符创建子项）后，该属性设置为 true。

例如，如果 Accordion 容器使用延迟的实例化，则在用户导航到 Accordion 容器的第二个窗格并且该窗格创建其子项后，此窗格的 processedDescriptors 属性才变为 true。但是，如果 Accordion 已将 creationPolicy 属性设置为 "all"，则在应用程序启动期间此容器第二个窗格的 processedDescriptors 属性设置为 true。

非容器类都没有描述符，所以对于这些类，createChildren() 方法创建任何内部组件子项后，该属性设置为 true。

用于确定自动化对象是否显示在自动化层次中的标志。层次中不可见的容器的子项显示为下一个最高可见父项的子项。通常，用于布局的容器（如框和画布）不显示在层次中。

如果合适，某些控件强制其子项在层次中显示。例如，List 控件将始终强制项呈示器（包括框）显示在层次中。实现程序必须支持将此属性设置为 true。

指定是否显示数据提供程序的根节点的布尔值标志。

如果数据提供程序具有根节点，但 showRoot 属性设置为 false，则 FlexNativeMenu 控件显示的顶级菜单项与根节点的直接子节点对应。

在使用没有根节点的数据提供程序（如 List 或 Array）时，此标志不起任何作用。

默认值为 true。

相关 API 元素

一个标志，确定某个对象是否已通过所有三个阶段的布局验证（假设需要通过所有验证）。

构造函数。

处理对组件设置的属性。

相关 API 元素

返回标识此容器中的子项的一组属性。在应用程序的生命期内，不应更改这些值。

参数

返回标识此容器中的子项的一组属性。在应用程序的生命期内，不应更改这些值。

参数

在指定位置弹出此菜单。

参数

在指定的索引位置提供自动化对象。该列表不应包含任何复合子项。

参数

提供自动化对象列表。该列表不应包含任何复合子项。

标记组件，以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。

Invalidation 是一个很有用的机制，可将组件更改延迟到稍后屏幕更新时进行处理，从而消除了重复的工作。例如，要更改文本颜色和大小，如果在更改颜色后立即进行更新，然后在设置大小后再更新大小，就有些浪费。同时更改两个属性后再使用新的大小和颜色一次性呈示文本，效率会更高。

很少调用 Invalidation 方法。通常，在组件上设置属性会自动调用合适的 invalidation 方法。

基于 keyEquivalentField 和 keyEquivalentFunction 属性返回给定数据对象的等效键。如果该方法无法将参数转换为字符串，则会返回一个空字符串。

参数

基于 keyEquivalentModifiersFunction 属性，返回给定数据对象的等效功能键。如果这种方法无法将此参数转换为功能键 Array，则返回一个空 Array。

参数

基于 labelField 和 labelFunction 属性返回用作给定数据对象的菜单项标签的字符串。如果该方法无法将参数转换为字符串，则会返回一个空格。

参数

基于 mnemonicIndexField 和 mnemonicIndexFunction 属性返回给定数据对象的助记键索引。如果这种方法无法将此参数转换为整数，则返回 -1。

参数

根据是否存在下划线字符从标签中提取助记键索引。如果存在前导下划线字符，则查找该字符并将其用作索引。

参数

确定用于 NativeMenuItem 的实际标签，方法为删除下划线字符，然后转换转义下划线字符（如果存在）。

参数

重放指定的事件。如果已在 superclass 中定义默认重放行为，组件作者可能应调用 super.replayAutomatableEvent。

参数

使用提供的 ID 解析子项。ID 是 createAutomationIDPart() 方法提供的一组属性。

参数

将 InteractiveObject 的上下文菜单设置为基础本机菜单。

参数

取消对已设为基础本机菜单的 InteractiveObject 上下文菜单的设置。

参数

验证子项的位置和大小，并绘制其他可视内容。如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateDisplayList() 方法，则当更新显示列表时会调用 validateDisplayList() 方法。

验证并更新此对象的属性和布局，并重绘该对象（如果需要）。

验证组件的属性。如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateProperties() 方法，则当提交属性值时会调用 validateProperties() 方法。

如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法，随后在测量时调用了 validateSize() 方法，则验证组件的度量大小。

参数

选择菜单项时调度。

此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息，请参阅详细的属性说明。

显示菜单或子菜单前调度。

此事件类型的事件对象属性包含以下值。并非所有属性对于各种事件都有意义。有关详细信息，请参阅详细的属性说明。