mx.controls.FlexNativeMenu (Flex 3)

(Apenas para o AIR)

Pacote	mx.controls
Classe	classe pública FlexNativeMenu
Herança	FlexNativeMenu EventDispatcher Object
Implementos	ILayoutManagerClient, IFlexContextMenu

O componente FlexNativeMenu providencia um wrapper para a classe NativeMenu do AIR. The FlexNativeMenu provides a way to define native operating system menus (such as window, application, and context menus) using techniques that are familiar to Flex developers and consistent with other Flex menu components, such as using MXML and data providers to specify menu structure. However, unlike Flex menu components, the menus that are defined by a FlexNativeMenu component are rendered by the host operating system as part of an AIR application, rather than being created as visual components by Flex.

Like other Flex menu components, to define the structure of a menu represented by a FlexNativeMenu component, you create a data provider such as an XML hierarchy or an array of objects containing data to be used to define the menu. Several properties can be set to define how the data provider data is interpreted, such as the labelField property to specify the data field that is used for the menu item label, the keyEquivalentField property to specify the field that defines a keyboard equivalent shortcut for the menu item, and the mnemonicIndexField property to specify the field that defines the index position of the character in the label that is used as the menu item's mnemonic.

The data provider for FlexNativeMenu items can specify several attributes that determine how the item is displayed and behaves, as the following XML data provider shows:

   <mx:XML format="e4x" id="myMenuData">
     <root>
        <menuitem label="MenuItem A">
            <menuitem label="SubMenuItem A-1" enabled="False"/>
            <menuitem label="SubMenuItem A-2"/>
        </menuitem>
        <menuitem label="MenuItem B" type="check" toggled="true"/>
        <menuitem label="MenuItem C" type="check" toggled="false"/>
        <menuitem type="separator"/>
        <menuitem label="MenuItem D">
            <menuitem label="SubMenuItem D-1"/>
            <menuitem label="SubMenuItem D-2"/>
            <menuitem label="SubMenuItem D-3"/>
        </menuitem>
    </root>
 </mx:XML>

The following table lists the attributes you can specify, their data types, their purposes, and how the data provider must represent them if the menu uses the DefaultDataDescriptor class to parse the data provider:

Attribute	Type	Description
`altKey`	Boolean	Specifies whether the Alt key is required as part of the key equivalent for the item.
`cmdKey`	Boolean	Specifies whether the Command key is required as part of the key equivalent for the item.
`ctrlKey`	Boolean	Specifies whether the Control key is required as part of the key equivalent for the item.
`enabled`	Boolean	Specifies whether the user can select the menu item (`true`), or not (`false`). If not specified, Flex treats the item as if the value were `true`. If you use the default data descriptor, data providers must use an `enabled` XML attribute or object field to specify this characteristic.
`keyEquivalent`	String	Specifies a keyboard character which, when pressed, triggers an event as though the menu item was selected. The menu's `keyEquivalentField` or `keyEquivalentFunction` property determines the name of the field in the data that specifies the key equivalent, or a function for determining the key equivalents. (If the data provider is in E4X XML format, you must specify one of these properties to assign a key equivalent.)
`label`	String	Specifies the text that appears in the control. This item is used for all menu item types except `separator`. The menu's `labelField` or `labelFunction` property determines the name of the field in the data that specifies the label, or a function for determining the labels. (If the data provider is in E4X XML format, you must specify one of these properties to display a label.) If the data provider is an Array of Strings, Flex uses the String value as the label.
`mnemonicIndex`	Integer	Specifies the index position of the character in the label that is used as the mnemonic for the menu item. The menu's `mnemonicIndexField` or `mnemonicIndexFunction` property determines the name of the field in the data that specifies the mnemonic index, or a function for determining mnemonic index. (If the data provider is in E4X XML format, you must specify one of these properties to specify a mnemonic index in the data.) Alternatively, you can indicate that a character in the label is the menu item's mnemonic by including an underscore immediately to the left of that character.
`shiftKey`	Boolean	Specifies whether the Shift key is required as part of the key equivalent for the item.
`toggled`	Boolean	Specifies whether a check item is selected. If not specified, Flex treats the item as if the value were `false` and the item is not selected. If you use the default data descriptor, data providers must use a `toggled` XML attribute or object field to specify this characteristic.
`type`	String	Specifies the type of menu item. Meaningful values are `separator` and `check`. Flex treats all other values, or nodes with no type entry, as normal menu entries. If you use the default data descriptor, data providers must use a `type` XML attribute or object field to specify this characteristic.

To create a window menu, set the FlexNativeMenu as the menu property of the Window or WindowedApplication instance on which the menu should appear. To create an application menu, assign the FlexNativeMenu as the menu property of the application's WindowedApplication. To assign a FlexNativeMenu as the context menu for a portion of the user interface, call the FlexNativeMenu instance's setContextMenu() method, passing the UI object as an argument. Call the FlexNativeMenu component's display() method to display the menu as a pop-up menu anywhere on one of the application's windows.

To detect when menu items commands are triggered, register a listener for the itemClick event. You can also register a listener for the menuShow event to determine when any menu or submenu is opened.

Sintaxe MXML expanded

Ocultar Sintaxe MXML

The <mx:FlexNativeMenu> tag supports the following tag attributes:

  <mx:FlexNativeMenu
    Propriedades 
    dataDescriptor="mx.controls.treeClasses.DefaultDataDescriptor"
    dataProvider="undefined"
    keyEquivalentField="keyEquivalent"
    keyEquivalentFunction="undefined"
    keyEquivalentModifiersFunction="undefined"
    labelField="label"
    labelFunction="undefined"
    mnemonicIndexField="mnemonicIndex"
    mnemonicIndexFunction="undefined"
    showRoot="true"
 
    Eventos
    itemClick="No default"
    menuShow="No default"
  />

Ver também

flash.display.NativeMenu
mx.events.FlexNativeMenuEvent

	Propriedade	Definido Por
		constructor : Object Uma referência ao objeto da classe ou função construtora para uma instância determinada de um objeto.	Object
		dataDescriptor : IMenuDataDescriptor The object that accesses and manipulates data in the data provider.	FlexNativeMenu
		dataProvider : Object The hierarchy of objects that are used to define the structure of menu items in the NativeMenu.	FlexNativeMenu
		hasRoot : Boolean [leitura-somente] A flag that indicates that the current data provider has a root node; for example, a single top node in a hierarchical structure.	FlexNativeMenu
		initialized : Boolean Um indicador que determina se um objeto passou por todas as três fases do layout: commitment, measurement, e layout (provido que algum foi requerido).	FlexNativeMenu
		keyEquivalentField : String The name of the field in the data provider that determines the key equivalent for each menu item.	FlexNativeMenu
		keyEquivalentFunction : Function The function that determines the key equivalent for each menu item.	FlexNativeMenu
		keyEquivalentModifiersFunction : Function The function that determines the key equivalent modifiers for each menu item.	FlexNativeMenu
		labelField : String The name of the field in the data provider that determines the text to display for each menu item.	FlexNativeMenu
		labelFunction : Function The function that determines the text to display for each menu item.	FlexNativeMenu
		mnemonicIndexField : String The name of the field in the data provider that determines the mnemonic index for each menu item.	FlexNativeMenu
		mnemonicIndexFunction : Function The function that determines the mnemonic index for each menu item.	FlexNativeMenu
		nativeMenu : NativeMenu [leitura-somente] Returns the flash.display.NativeMenu managed by this object, or null if there is not one.	FlexNativeMenu
		nestLevel : int Profundidade desse objeto na hierarquia do containment.	FlexNativeMenu
		processedDescriptors : Boolean Colocado para true após criação de child imediato ou atrasado, dependendo de qual aconteça.	FlexNativeMenu
		prototype : Object [static] Uma referência ao objeto protótipo de uma classe ou função de objeto.	Object
		showRoot : Boolean A Boolean flag that specifies whether to display the data provider's root node.	FlexNativeMenu
		updateCompletePendingFlag : Boolean Um indicador que determina se um objeto passou por todas as três fases de validação de layout (provido que algum foi requerido).	FlexNativeMenu

	Método	Definido Por
		FlexNativeMenu() Constructor.	FlexNativeMenu
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto event listener com um objeto do EventDispatcher para que o listener receba notificação de um evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Despacha um evento no fluxo de eventos.	EventDispatcher
		display(stage:Stage, stageX:Number, stageY:Number):void Pops up this menu at the specified location.	FlexNativeMenu
		hasEventListener(type:String):Boolean Verifica se o objeto do EventDispatcher tem listeners registrados para um tipo determinado de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade específica definida.	Object
		invalidateProperties():void Marca um componente para que seu método commitProperties() seja chamado durante um atualização de tela tardia.	FlexNativeMenu
		isPrototypeOf(theClass:Object):Boolean Indica se uma instância da classe Object está na corrente do protótipo do objeto determinado como parâmetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e se é enumerável.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um listener do objeto do EventDispatcher.	EventDispatcher
		setContextMenu(component:InteractiveObject):void Sets the context menu of the InteractiveObject to the underlying native menu.	FlexNativeMenu
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Determina a disponibilidade de uma propriedade dinâmica para operações em loop.	Object
		toString():String Retorna a representação em string de um objeto determinado.	Object
		unsetContextMenu(component:InteractiveObject):void Unsets the context menu of the InteractiveObject that has been set to the underlying native menu.	FlexNativeMenu
		validateDisplayList():void Valida a posição e tamanho de children e desenha outros visuais.	FlexNativeMenu
		validateNow():void Validates and updates the properties and layout of this object and redraws it, if necessary.	FlexNativeMenu
		validateProperties():void Valida as propriedades de um componente.	FlexNativeMenu
		validateSize(recursive:Boolean = false):void Valida o tamanho medido do componente se o método LayoutManager.invalidateSize() for chamado com esse ILayoutManagerClient, depois o método validateSize é chamado quando é hora de fazer medidas.	FlexNativeMenu
		valueOf():Object Retorna o valor primitivo de um objeto específico.	Object
		willTrigger(type:String):Boolean Verifica se um event listener está registrado com esse objeto do EventDispatcher ou qualquer um de seus parents para o determinado tipo de evento.	EventDispatcher

	Método	Definido Por
		commitProperties():void Processa as propriedades determinadas no componente.	FlexNativeMenu
		itemToKeyEquivalent(data:Object):String Returns the key equivalent for the given data object based on the keyEquivalentField and keyEquivalentFunction properties.	FlexNativeMenu
		itemToKeyEquivalentModifiers(data:Object):Array Returns the key equivalent modifiers for the given data object based on the keyEquivalentModifiersFunction property.	FlexNativeMenu
		itemToLabel(data:Object):String Returns the String to use as the menu item label for the given data object, based on the labelField and labelFunction properties.	FlexNativeMenu
		itemToMnemonicIndex(data:Object):int Returns the mnemonic index for the given data object based on the mnemonicIndexField and mnemonicIndexFunction properties.	FlexNativeMenu
		parseLabelToMnemonicIndex(data:String):int Extracts the mnemonic index from a label based on the presence of an underscore character.	FlexNativeMenu
		parseLabelToString(data:String):String Determines the actual label to be used for the NativeMenuItem by removing underscore characters and converting escaped underscore characters, if there are any.	FlexNativeMenu

Sumário	Definido Por
activate	Despachado quando o Flash Player ou um aplicativo AIR obtém foco do sistema operacional e se torna ativo.	EventDispatcher
deactivate	Despachado quando o Flash Player ou um aplicativo AIR perde o foco do sistema operacional e está se tornando inativo.	EventDispatcher
itemClick	Dispatched when a menu item is selected.	FlexNativeMenu
menuShow	Dispatched before a menu or submenu is displayed.	FlexNativeMenu

Detalhe da Propriedade

dataDescriptor

propriedade

dataDescriptor:IMenuDataDescriptor [ler-escrever]

The object that accesses and manipulates data in the data provider. The FlexNativeMenu control delegates to the data descriptor for information about its data. This data is then used to parse and move about the data source. The data descriptor defined for the FlexNativeMenu is used for all child menus and submenus.

When you specify this property as an attribute in MXML, you must use a reference to the data descriptor, not the string name of the descriptor. Use the following format for setting the property:

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

Alternatively, you can specify the property in MXML as a nested subtag, as the following example shows:

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

O valor padrão é an internal instance of the DefaultDataDescriptor class.

Implementação
public function get dataDescriptor():IMenuDataDescriptor
public function set dataDescriptor(value:IMenuDataDescriptor):void

dataProvider

propriedade

dataProvider:Object [ler-escrever]

The hierarchy of objects that are used to define the structure of menu items in the NativeMenu. Individual data objects define menu items, and items with child items become menus and submenus.

The FlexNativeMenu control handles the source data object as follows:

A String containing valid XML text is converted to an XML object.
An XMLNode is converted to an XML object.
An XMLList is converted to an XMLListCollection.
Any object that implements the ICollectionView interface is cast to an ICollectionView.
An Array is converted to an ArrayCollection.
Any other type object is wrapped in an Array with the object as its sole entry.

O valor padrão é "undefined".

Essa propriedade pode ser usada como a fonte para a união de dados.

Implementação
public function get dataProvider():Object
public function set dataProvider(value:Object):void

hasRoot

propriedade

hasRoot:Boolean [leitura-somente]

A flag that indicates that the current data provider has a root node; for example, a single top node in a hierarchical structure. XML and Object are examples of types that have a root node, while Lists and Arrays do not.

Implementação
public function get hasRoot():Boolean

initialized

propriedade

initialized:Boolean [ler-escrever]

Um indicador que determina se um objeto passou por todas as três fases do layout: commitment, measurement, e layout (provido que algum foi requerido).

Implementação
public function get initialized():Boolean
public function set initialized(value:Boolean):void

keyEquivalentField

propriedade

keyEquivalentField:String [ler-escrever]

The name of the field in the data provider that determines the key equivalent for each menu item. The set of values is defined in the Keyboard class, in the KEYNAME_XXXX constants. For example, consult that list for the value for a control character such as Home, Insert, etc.

Setting the keyEquivalentFunction property causes this property to be ignored.

O valor padrão é "keyEquivalent".

Essa propriedade pode ser usada como a fonte para a união de dados.

Implementação
public function get keyEquivalentField():String
public function set keyEquivalentField(value:String):void

Ver também

flash.ui.Keyboard

keyEquivalentFunction

propriedade

keyEquivalentFunction:Function [ler-escrever]

The function that determines the key equivalent for each menu item. If you omit this property, Flex uses the contents of the field or attribute specified by the keyEquivalentField property. If you specify this property, Flex ignores any keyEquivalentField property value.

The keyEquivalentFunction property is good for handling formatting, localization, and platform independence.

The key equivalent function must take a single argument, which is the item in the data provider, and must return a String.

myKeyEquivalentFunction(item:Object):String

O valor padrão é "undefined".

Essa propriedade pode ser usada como a fonte para a união de dados.

Implementação
public function get keyEquivalentFunction():Function
public function set keyEquivalentFunction(value:Function):void

Ver também

flash.ui.Keyboard

keyEquivalentModifiersFunction

propriedade

keyEquivalentModifiersFunction:Function [ler-escrever]

The function that determines the key equivalent modifiers for each menu item. If you omit this property, Flex uses its own default function to determine the Array of modifiers by looking in the data provider data for the presence of the following (boolean) fields: altKey, cmdKey, ctrlKey, and shiftKey.

The keyEquivalentModifiersFunction property is good for handling formatting, localization, and platform independence.

The key equivalent modifiers function must take a single argument, which is the item in the data provider, and must return an array of modifier key names.

myKeyEquivalentModifiersFunction(item:Object):Array

O valor padrão é "undefined".

Essa propriedade pode ser usada como a fonte para a união de dados.

Implementação
public function get keyEquivalentModifiersFunction():Function
public function set keyEquivalentModifiersFunction(value:Function):void

labelField

propriedade

labelField:String [ler-escrever]

The name of the field in the data provider that determines the text to display for each menu item. If the data provider is an Array of Strings, Flex uses each string value as the label. If the data provider is an E4X XML object, you must set this property explicitly. For example, if each XML elementin an E4X XML Object includes a "label" attribute containing the text to display for each menu item, set the labelField to "@label".

In a label, you can specify the character to be used as the mnemonic index by preceding it with an underscore. For example, a label value of "C_ut" sets the mnemonic index to 1. Only the first underscore present is used for this purpose. To display a literal underscore character in the label, you can escape it using a double underscore. For example, a label value of "C__u_t" would result in a menu item with the label "C_ut" and a mnemonic index of 3 (the "t" character). If the field defined in the mnemonicIndexField property is present and set to a value greater than zero, that value takes precedence over any underscore-specified mnemonic index value.

Setting the labelFunction property causes this property to be ignored.

O valor padrão é "label".

Essa propriedade pode ser usada como a fonte para a união de dados.

Implementação
public function get labelField():String
public function set labelField(value:String):void

labelFunction

propriedade

labelFunction:Function [ler-escrever]

The function that determines the text to display for each menu item. The label function must find the appropriate field or fields in the data provider and return a displayable string.

If you omit this property, Flex uses the contents of the field or attribute specified by the labelField property. If you specify this property, Flex ignores any labelField property value.

The labelFunction property can be helpful for handling formatting, localization, and platform-independence.

The label function must take a single argument, which is the item in the data provider, and must return a String.

myLabelFunction(item:Object):String

O valor padrão é "undefined".

Essa propriedade pode ser usada como a fonte para a união de dados.

Implementação
public function get labelFunction():Function
public function set labelFunction(value:Function):void

mnemonicIndexField

propriedade

mnemonicIndexField:String [ler-escrever]

The name of the field in the data provider that determines the mnemonic index for each menu item.

If the field specified by this property contains a number greater than zero, that mnemonic index takes precedence over one specified by an underscore in the label.

Setting the mnemonicIndexFunction property causes this property to be ignored.

O valor padrão é "mnemonicIndex".

Essa propriedade pode ser usada como a fonte para a união de dados.

Implementação
public function get mnemonicIndexField():String
public function set mnemonicIndexField(value:String):void

Ver também

labelField

mnemonicIndexFunction

propriedade

mnemonicIndexFunction:Function [ler-escrever]

The function that determines the mnemonic index for each menu item.

If you omit this property, Flex uses the contents of the field or attribute specified by the mnemonicIndexField property. If you specify this property, Flex ignores any mnemonicIndexField property value.

If this property is defined and the function returns a number greater than zero for a data item, the returned mnemonic index takes precedence over one specified by an underscore in the label.

The mnemonicIndexFunction property is good for handling formatting, localization, and platform independence.

The mnemonic index function must take a single argument which is the item in the data provider and return an int.

myMnemonicIndexFunction(item:Object):int

O valor padrão é "undefined".

Essa propriedade pode ser usada como a fonte para a união de dados.

Implementação
public function get mnemonicIndexFunction():Function
public function set mnemonicIndexFunction(value:Function):void

nativeMenu

propriedade

nativeMenu:NativeMenu [leitura-somente]

Returns the flash.display.NativeMenu managed by this object, or null if there is not one. Any changes made directly to the underlying NativeMenu instance may be lost when changes are made to the menu or the underlying data provider.

Essa propriedade pode ser usada como a fonte para a união de dados.

Implementação
public function get nativeMenu():NativeMenu

nestLevel

propriedade

nestLevel:int [ler-escrever]

Profundidade desse objeto na hierarquia do containment. This number is used by the measurement and layout code. The value is 0 if this component is not on the DisplayList.

Implementação
public function get nestLevel():int
public function set nestLevel(value:int):void

processedDescriptors

propriedade

processedDescriptors:Boolean [ler-escrever]

Colocado para true após criação de child imediato ou atrasado, dependendo de qual aconteça. For a Container object, it is set to true at the end of the createComponentsFromDescriptors() method, meaning after the Container object creates its children from its child descriptors.

For example, if an Accordion container uses deferred instantiation, the processedDescriptors property for the second pane of the Accordion container does not become true until after the user navigates to that pane and the pane creates its children. But, if the Accordion had set the creationPolicy property to "all", the processedDescriptors property for its second pane is set to true during application startup.

For classes that are not containers, which do not have descriptors, it is set to true after the createChildren() method creates any internal component children.

Implementação
public function get processedDescriptors():Boolean
public function set processedDescriptors(value:Boolean):void

showRoot

propriedade

showRoot:Boolean [ler-escrever]

A Boolean flag that specifies whether to display the data provider's root node.

If the data provider has a root node, and the showRoot property is set to false, the top-level menu items displayed by the FlexNativeMenu control correspond to the immediate descendants of the root node.

This flag has no effect when using a data provider without a root nodes, such as a List or Array.

O valor padrão é true.

Implementação
public function get showRoot():Boolean
public function set showRoot(value:Boolean):void

Ver também

hasRoot

updateCompletePendingFlag

propriedade

updateCompletePendingFlag:Boolean [ler-escrever]

Um indicador que determina se um objeto passou por todas as três fases de validação de layout (provido que algum foi requerido).

Implementação
public function get updateCompletePendingFlag():Boolean
public function set updateCompletePendingFlag(value:Boolean):void

Detalhe do Construtor

FlexNativeMenu

()

Construtor

public function FlexNativeMenu()

Constructor.

Detalhe do Método

commitProperties

()

método

protected function commitProperties():void

Processa as propriedades determinadas no componente.

Ver também

mx.core.UIComponent.commitProperties()

display

()

método

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

Pops up this menu at the specified location.

Parâmetros

	`stage:Stage` — The Stage object on which to display this menu.

	`stageX:Number` — The number of horizontal pixels, relative to the origin of stage, at which to display this menu.

	`stageY:Number` — The number of vertical pixels, relative to the origin of stage, at which to display this menu.

invalidateProperties

()

método

public function invalidateProperties():void

Marca um componente para que seu método commitProperties() seja chamado durante um atualização de tela tardia.

Invalidation is a useful mechanism for eliminating duplicate work by delaying processing of changes to a component until a later screen update. For example, if you want to change the text color and size, it would be wasteful to update the color immediately after you change it and then update the size when it gets set. It is more efficient to change both properties and then render the text with its new size and color once.

Invalidation methods rarely get called. In general, setting a property on a component automatically calls the appropriate invalidation method.

itemToKeyEquivalent

()

método

protected function itemToKeyEquivalent(data:Object):String

Returns the key equivalent for the given data object based on the keyEquivalentField and keyEquivalentFunction properties. If the method cannot convert the parameter to a String, it returns an empty string.

Parâmetros

data:Object — Object to be displayed.

Retorna

String — The key equivalent based on the data.

itemToKeyEquivalentModifiers

()

método

protected function itemToKeyEquivalentModifiers(data:Object):Array

Returns the key equivalent modifiers for the given data object based on the keyEquivalentModifiersFunction property. If the method cannot convert the parameter to an Array of modifiers, it returns an empty Array.

Parâmetros

data:Object — Object to be displayed.

Retorna

Array — The array of key equivalent modifiers based on the data

itemToLabel

()

método

protected function itemToLabel(data:Object):String

Returns the String to use as the menu item label for the given data object, based on the labelField and labelFunction properties. Se o método não puder converter o parâmetro em um String, ele retornará um espaço único.

Parâmetros

data:Object — Object to be displayed.

Retorna

String — The string to be displayed based on the data.

itemToMnemonicIndex

()

método

protected function itemToMnemonicIndex(data:Object):int

Returns the mnemonic index for the given data object based on the mnemonicIndexField and mnemonicIndexFunction properties. If the method cannot convert the parameter to an integer, it returns -1.

Parâmetros

data:Object — Object to be displayed.

Retorna

int — The mnemonic index based on the data.

parseLabelToMnemonicIndex

()

método

protected function parseLabelToMnemonicIndex(data:String):int

Extracts the mnemonic index from a label based on the presence of an underscore character. It finds the leading underscore character if there is one and uses that as the index.

Parâmetros

data:String

Retorna

int

parseLabelToString

()

método

protected function parseLabelToString(data:String):String

Determines the actual label to be used for the NativeMenuItem by removing underscore characters and converting escaped underscore characters, if there are any.

Parâmetros

data:String

Retorna

String

setContextMenu

()

método

public function setContextMenu(component:InteractiveObject):void

Sets the context menu of the InteractiveObject to the underlying native menu.

Parâmetros

component:InteractiveObject

unsetContextMenu

()

método

public function unsetContextMenu(component:InteractiveObject):void

Unsets the context menu of the InteractiveObject that has been set to the underlying native menu.

Parâmetros

component:InteractiveObject

validateDisplayList

()

método

public function validateDisplayList():void

Valida a posição e tamanho de children e desenha outros visuais. If the LayoutManager.invalidateDisplayList() method is called with this ILayoutManagerClient, then the validateDisplayList() method is called when it's time to update the display list.

validateNow

()

método

public function validateNow():void

Validates and updates the properties and layout of this object and redraws it, if necessary.

validateProperties

()

método

public function validateProperties():void

Valida as propriedades de um componente. If the LayoutManager.invalidateProperties() method is called with this ILayoutManagerClient, then the validateProperties() method is called when it's time to commit property values.

validateSize

()

método

public function validateSize(recursive:Boolean = false):void

Valida o tamanho medido do componente se o método LayoutManager.invalidateSize() for chamado com esse ILayoutManagerClient, depois o método validateSize é chamado quando é hora de fazer medidas.

Parâmetros

recursive:Boolean (default = false) — If true, call this method on the objects children.

Detalhe do Evento

itemClick

Evento

Event Object Type: mx.events.FlexNativeMenuEvent
FlexNativeMenuEvent.type property = mx.events.FlexNativeMenuEvent.ITEM_CLICK

Dispatched when a menu item is selected.

The FlexNativeMenuEvent.ITEM_CLICK tipo de evento constant indicates that the user selected a menu item.

As propreidades do objeto de evento para esse tipo de evento tem os seguintes valores. Nem todas as propriedades são significativas para todos as espécies de eventos. Veja as descrições das propriedades detalhadas para maiores informações.

Propriedade	Valor
`bubbles`	false
`cancelable`	true
`currentTarget`	O Object que define o event listener que cuida do evento. Por exemplo, se você usar o myButton.addEventListener() para registrar um event listener, myButton é o valor do currentTarget.
`index`	The index in the menu of the selected menu item.
`item`	The item in the dataProvider that was selected.
`label`	The label text of the selected menu item.
`nativeMenu`	The specific NativeMenu instance associated with this event.
`nativeMenuItem`	The specific NativeMenuItem instance associated with this event.
`target`	O Object que despachou o evento; nem sempre é o Object que escuta pelo evento. Use a propriedade currentTarget para sempre acessar o Objeto que faz a escuta pelo evento.
`type`	FlexNativeMenuEvent.ITEM_CLICK

menuShow

Evento

Event Object Type: mx.events.FlexNativeMenuEvent
FlexNativeMenuEvent.type property = mx.events.FlexNativeMenuEvent.MENU_SHOW

Dispatched before a menu or submenu is displayed.

The FlexNativeMenuEvent.MENU_SHOW type constant indicates that the mouse pointer rolled a menu or submenu opened.

Propriedade	Valor
`bubbles`	false
`cancelable`	true
`currentTarget`	O Object que define o event listener que cuida do evento. Por exemplo, se você usar o myButton.addEventListener() para registrar um event listener, myButton é o valor do currentTarget.
`index`	-1. This property is not set for this type of event.
`item`	null. This property is not set for this type of event.
`label`	null. This property is not set for this type of event.
`nativeMenu`	The specific NativeMenu instance associated with this event.
`nativeMenuItem`	null. This property is not set for this type of event.
`target`	O Object que despachou o evento; nem sempre é o Object que escuta pelo evento. Use a propriedade currentTarget para sempre acessar o Objeto que faz a escuta pelo evento.
`type`	FlexNativeMenuEvent.MENU_SHOW

ActionScript 3.0 Language and Components Reference	All Packages \| All Classes \| Language Elements \| Index \| Appendixes \| Conventions \| Frames No Frames
FlexNativeMenu	Properties \| Methods \| Events