FlexNativeMenu  - AS3 Flex

Objet délégué qui traite la fonction d’automatisation.

True si ce composant est activé pour l’automatisation, false dans le cas contraire.

Nom pouvant être utilisé comme identifiant de cet objet.

Propriétaire de ce composant à des fins d’automatisation.

Parent de ce composant à des fins d’automatisation.

Implémentation de l’interface IAutomationTabularData, qui peut être utilisée pour récupérer les données.

Cette valeur correspond généralement à l’apparence rendue de l’objet et doit être utilisable pour associer l’identifiant à l’objet lorsqu’il apparaît visuellement dans l’application.

True si ce composant est visible pour l’automatisation, false dans le cas contraire.

Objet qui accède aux objets du fournisseur de données et les manipule. Le contrôle FlexNativeMenu délègue au descripteur de données pour obtenir des informations sur ses données. Ces données sont ensuite utilisées pour analyser et déplacer la source de données. Le descripteur de données défini pour le contrôle FlexNativeMenu est utilisé pour tous les menus enfant et les sous-menus.

Lorsque vous spécifiez cette propriété comme attribut dans MXML, vous devez utiliser une référence au descripteur de données et pas le nom de chaîne du descripteur. Utilisez le format suivant pour définir la propriété :

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

Vous pouvez également spécifier la propriété dans MXML comme sous-balise imbriquée, comme le montre l’exemple suivant :

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

Valeur par défaut d’une instance interne de la classe DefaultDataDescriptor.

Hiérarchie des objets qui sont utilisés pour définir la structure des éléments de menu dans le composant NativeMenu. Les objets de données individuels définissent les éléments de menu et les éléments dotés d’éléments enfant deviennent des menus et sous-menus.

Le contrôle FlexNativeMenu gère l’objet de données source comme suit :

• Une chaîne contenant du texte XML valide est convertie en objet XML.
• Un objet XMLNode est converti en objet XML.
• Un objet XMLList est converti en objet XMLListCollection.
• N’importe quel objet qui implémente l’interface ICollectionView est distribué à un objet ICollectionView.
• Un objet Array est converti en objet ArrayCollection.
• Tout autre type d’objet est enroulé dans un objet Array (l’objet étant sa seule entrée).

La valeur par défaut est "undefined".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement collectionChange .

Indicateur précisant que le fournisseur de données actuel comporte un nœud racine. Par exemple, un nœud supérieur unique dans une structure hiérarchique. XML et Object sont des exemples de types dotés de nœuds racine, tandis que List and Array n’en ont pas.

Indicateur déterminant si un objet a traversé les trois phases de présentation : validation, mesure et présentation (si besoin était).

Nom du champ dans le fournisseur de données qui détermine l’équivalence de touches de chaque élément de menu. Le jeu de valeurs est défini dans la classe Keyboard, dans les constantes KEYNAME_XXXX. Par exemple, consultez cette liste pour connaître la valeur d’un caractère de contrôle comme Début, Inser, etc.

Si vous définissez la propriété keyEquivalentFunction, elle est ignorée.

La valeur par défaut est "keyEquivalent".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement keyEquivalentChanged .

Eléments de l’API associés

Fonction qui détermine l’équivalence de touches de chaque élément de menu. Si vous omettez cette propriété, Flex utilise le contenu du champ ou de l’attribut spécifié par la propriété keyEquivalentField. Si vous spécifiez cette propriété, Flex ignore toute valeur de la propriété keyEquivalentField.

La propriété keyEquivalentFunction permet de gérer la mise en forme, la localisation et l’indépendance des plates-formes.

La fonction d’équivalence de touches doit prendre un seul argument, qui est l’élément dans le fournisseur de données et renvoyer une chaîne.

myKeyEquivalentFunction(item:Object):String

La valeur par défaut est "undefined".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement keyEquivalentFunctionChanged .

Eléments de l’API associés

Fonction qui détermine les modificateurs d’équivalence de touches de chaque élément de menu. Si vous omettez cette propriété, Flex utilise sa propre fonction pour déterminer le tableau de modificateurs en recherchant dans les données du fournisseur de données la présence des champs (booléens) suivants : altKey, commandKey, controlKey et shiftKey.

La propriété keyEquivalentModifiersFunction permet de gérer la mise en forme, la localisation et l’indépendance des plates-formes.

Les modificateurs d’équivalence de touches doivent prendre un seul argument, qui est l’élément dans le fournisseur de données et renvoyer un tableau de noms de touches de modificateurs.

myKeyEquivalentModifiersFunction(item:Object):Array

La valeur par défaut est "undefined".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement keyEquivalentModifiersFunctionChanged .

Nom du champ dans le fournisseur de données qui détermine le texte à afficher pour chaque élément de menu. Si le fournisseur de données est un tableau de chaînes, Flex utilise chaque valeur de chaîne comme libellé. Si le fournisseur de données est un objet E4X XML, vous devez définir explicitement cette propriété. Par exemple, si chaque élément XML d’un objet E4X XML inclut un attribut « label » qui comporte le texte à afficher pour chaque élément de menu, définissez la propriété labelField sur "@label".

Dans une étiquette, vous pouvez spécifier le caractère à utiliser comme index mnémonique en le faisant précéder d’un caractère de soulignement. Par exemple, la valeur d’étiquette "C_ut" définit l’index mnémonique sur 1. Seul le premier caractère de soulignement présent est utilisé dans ce but. Pour afficher un caractère de soulignement littéral dans l’étiquette, utilisez deux caractères de soulignement. Par exemple, la valeur d’étiquette "C__u_t" donnera un élément de menu portant l’étiquette « C_ut » et doté d’un index mnémonique de 3 (le caractère « t »). Si le champ défini dans la propriété mnemonicIndexField est présent et défini sur une valeur supérieure à zéro, cette valeur a priorité par rapport à toute valeur d’index mnémonique spécifiée par un caractère de soulignement.

Si vous définissez la propriété labelFunction, elle est ignorée.

La valeur par défaut est "label".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement labelFieldChanged .

Fonction qui détermine le texte à afficher pour chaque élément de menu. La fonction d’étiquette doit trouver le ou les champs appropriés dans le fournisseur de données et renvoyer une chaîne à afficher.

Si vous omettez cette propriété, Flex utilise le contenu du champ ou de l’attribut spécifié par la propriété labelField. Si vous spécifiez cette propriété, Flex ignore toute valeur de la propriété labelField.

La propriété labelFunction permet de gérer la mise en forme, la localisation et l’indépendance des plates-formes.

La fonction d’étiquette doit prendre un seul argument, qui est l’élément dans le fournisseur de données et renvoyer une chaîne.

myLabelFunction(item:Object):String

La valeur par défaut est "undefined".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement labelFunctionChanged .

Nom du champ dans le fournisseur de données qui détermine l’index mnémonique de chaque élément de menu.

Si le champ spécifié par cette propriété contient un nombre supérieur à zéro, cet index mnémonique a priorité par rapport à un autre index spécifié par un caractère de soulignement dans l’étiquette.

Si vous définissez la propriété mnemonicIndexFunction, elle est ignorée.

La valeur par défaut est "mnemonicIndex".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement mnemonicIndexChanged .

Eléments de l’API associés

Fonction qui détermine l’index mnémonique de chaque élément de menu.

Si vous omettez cette propriété, Flex utilise le contenu du champ ou de l’attribut spécifié par la propriété mnemonicIndexField. Si vous spécifiez cette propriété, Flex ignore toute valeur de la propriété mnemonicIndexField.

Si cette propriété est définie et que la fonction renvoie un nombre supérieur à zéro pour l’élément de données, l’index mnémonique renvoyé a priorité par rapport à celui qui est spécifié par un caractère de soulignement dans l’étiquette.

La propriété mnemonicIndexFunction permet de gérer la mise en forme, la localisation et l’indépendance des plates-formes.

La fonction d’index mnémonique doit prendre un seul argument, qui est l’élément dans le fournisseur de données et renvoyer un nombre entier.

myMnemonicIndexFunction(item:Object):int

La valeur par défaut est "undefined".

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement mnemonicIndexFunctionChanged .

Renvoie l’instance flash.display.NativeMenu gérée par cet objet, ou la valeur null s’il n’en existe aucune. Toute modification apportée directement à l’instance NativeMenu sous-jacente risque d’être perdue lorsque des changements sont apportés au menu ou au fournisseur de données sous-jacent.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement nativeMenuUpdate .

Profondeur de cet objet dans la hiérarchie de confinement. Ce nombre est utilisé par le code de mesure et de présentation. La valeur est 0 si ce composant n’est pas dans la liste DisplayList.

Nombre d’enfants d’automatisation que ce conteneur comporte. Cette somme ne doit inclure aucun enfant composite, bien qu’elle inclue les enfants non significatifs dans la hiérarchie d’automatisation.

Définie sur true après la création d’enfant immédiate ou différée, en fonction de celle effectuée. Pour un objet Container, elle est définie sur true à la fin de la méthode createComponentsFromDescriptors(), donc après la création des enfants du conteneur à partir de ses descripteurs enfant.

Par exemple, si un conteneur Accordion utilise l’instanciation différée, la propriété processedDescriptors pour le deuxième volet du conteneur Accordion ne prend pas la valeur true jusqu’à ce que l’utilisateur accède au volet et que le volet crée ses enfants. Si toutefois le composant Accordion a défini la propriété creationPolicy sur "all", la propriété processedDescriptors de son deuxième panneau est définie sur true au démarrage de l’application.

Pour les classes qui ne sont pas des conteneurs, qui n’ont pas de descripteurs, elle est définie sur true après la création des enfants de composant internes éventuels par la méthode createChildren().

Indicateur qui détermine si un objet d’automatisation s’affiche dans la hiérarchie d’automatisation. Les enfants des conteneurs qui ne sont pas visibles dans la hiérarchie apparaissent en tant qu’enfants du parent visible le plus élevé suivant. En général, les conteneurs utilisés pour la présentation (par exemple, cases et dessins) n’apparaissent pas dans la hiérarchie.

Certains contrôles forcent leurs enfants à apparaître dans la hiérarchie lorsque cela est approprié. Par exemple, une liste force toujours les fonctionnalités de rendu d’éléments, y compris les cases, à apparaître dans la hiérarchie. Les implémentateurs doivent prendre en charge la définition de cette propriété sur true.

Indicateur booléen spécifiant si le nœud racine du fournisseur de données doit être affiché.

Si le fournisseur de données comporte un nœud racine et si la propriété showRoot est définie sur false, les éléments du menu de niveau supérieur affichés par le contrôle FlexNativeMenu correspondent aux descendants immédiats du nœud racine.

Cet indicateur n’a aucun effet lorsque vous utilisez un fournisseur de données sans nœud racine, comme l’objet List ou Array.

La valeur par défaut est true.

Eléments de l’API associés

Indicateur déterminant si un objet a traversé les trois phases de validation de mise en forme (si besoin était).

Constructeur.

Traite les propriétés définies sur le composant.

Eléments de l’API associés

Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. Ces valeurs ne doivent pas changer pendant la durée de vie de l’application.

Paramètres

Renvoie un ensemble de propriétés qui identifient l’enfant au sein de ce conteneur. Ces valeurs ne doivent pas changer pendant la durée de vie de l’application.

Paramètres

Déroule ce menu à l’emplacement spécifié.

Paramètres

Fournit l’objet d’automatisation à l’index spécifié. Cette liste ne doit inclure aucun enfant composite.

Paramètres

Fournit la liste d’objets d’automatisation. Cette liste n’inclut aucun enfant composite.

Marque un composant de sorte que sa méthode commitProperties() soit appelée au cours d’une actualisation d’écran ultérieure.

L’invalidation est un mécanisme efficace pour éliminer la répétition inutile d’opérations. Elle retarde le traitement des modifications apportées à un composant à une actualisation d’écran ultérieure. Par exemple, si vous souhaitez modifier la couleur du texte et la taille de la police, il est inutile de mettre à jour la couleur immédiatement après sa modification, puis de réaliser une autre mise à jour pour la taille de police. Il est plus efficace de modifier les deux propriétés et de rendre le texte une seule fois avec sa nouvelle couleur et sa nouvelle taille.

Les méthodes d’invalidation sont rarement appelées. En général, le fait de définir une propriété sur un composant provoque automatiquement l’appel de la méthode d’invalidation adaptée.

Renvoie l’équivalence de touches de l’objet de données fourni en fonction des propriétés keyEquivalentField et keyEquivalentFunction. Si la méthode ne peut pas convertir le paramètre en chaîne, elle renvoie une chaîne vide.

Paramètres

Renvoie les modificateurs d’équivalence de touches de l’objet de données fourni en fonction de la propriété keyEquivalentModifiersFunction. Si la méthode ne peut pas convertir le paramètre en tableau de modificateurs, elle renvoie un tableau vide.

Paramètres

Renvoie la chaîne à utiliser comme étiquette d’élément de menu pour l’objet de données fourni en fonction des propriétés labelField et labelFunction. Si la méthode ne peut pas convertir le paramètre en chaîne, elle renvoie un espace unique.

Paramètres

Renvoie l’index mnémonique de l’objet de données fourni en fonction des propriétés mnemonicIndexField et mnemonicIndexFunction. Si la méthode ne peut pas convertir le paramètre en nombre entier, elle renvoie la valeur -1.

Paramètres

Extrait l’index mnémonique d’une étiquette en fonction de la présence d’un caractère de soulignement. Elle trouve le caractère de soulignement de début s’il existe et l’utilise comme index.

Paramètres

Détermine l’étiquette réelle à utiliser pour le composant NativeMenuItem en supprimant les caractères de soulignement et en convertissant les caractères de soulignement ignorés, s’il en existe.

Paramètres

Réexécute l’événement spécifié. Un auteur de composant doit probablement appeler l’événement super.replayAutomatableEvent si le comportement de réexécution par défaut a été défini dans une super-classe.

Paramètres

Résout un enfant en utilisant l’ID fourni. L’ID est un ensemble de propriétés tel que fourni par la méthode createAutomationIDPart().

Paramètres

Définit le menu contextuel du composant InteractiveObject sur le menu natif sous-jacent.

Paramètres

Annule la définition du menu contextuel du composant InteractiveObject qui a été défini sur le menu natif sous-jacent.

Paramètres

Valide la position et la taille des enfants, et trace d’autres effets visuels. Si la méthode LayoutManager.invalidateDisplayList() est appelée avec cette interface ILayoutManagerClient, la méthode validateDisplayList() est alors appelée lorsqu’il est temps de mettre à jour la liste d’affichage.

Valide et actualise les propriétés et la mise en forme de cet objet, puis le retrace si nécessaire.

Valide les propriétés d’un composant. Si la méthode LayoutManager.invalidateProperties() est appelée avec cette interface ILayoutManagerClient, la méthode validateProperties() est alors appelée lorsqu’il est temps de valider les valeurs de propriété.

Valide la taille mesurée du composant si la méthode LayoutManager.invalidateSize() est appelée avec cette interface ILayoutManagerClient, puis la méthode validateSize() est appelée lorsqu’il est temps d’effectuer les mesures.

Paramètres

Distribué lorsqu’un élément de menu est sélectionné.

Les valeurs des propriétés de l’objet d’événement de ce type d’événement sont les suivantes. Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.

Distribué avant l’affichage d’un menu ou sous-menu.

Les valeurs des propriétés de l’objet d’événement de ce type d’événement sont les suivantes. Toutes les propriétés ne sont pas pertinentes pour chaque catégorie d’événements. Pour plus d’informations, voir les descriptions détaillées des propriétés.