PopUpMenuButton  - AS3 Flex

Le descripteur de données accède aux objets du fournisseur de données et les manipule.

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 la propriété :

<mx:PopUpMenuButton id="menubar" 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:PopUpMenuButton>
      <mx:dataDescriptor>
         <myCustomDataDescriptor>
      </mx:dataDescriptor>
      ...

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

DataProvider for popUpMenu.

La valeur par défaut est null.

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 .

Nom du champ du tableau dataProvider qui contient l’icône à afficher pour chaque élément de menu. La propriété iconFunction, si elle définie, remplace cette propriété.

Le rendu d’élément recherche dans le fournisseur de données une propriété portant le nom spécifié dans la propriété iconField. Si la valeur de la propriété est une classe, cette dernière est instanciée et sera probablement une instance d’un objet IFlexDisplayObject. Si la valeur de la propriété est une chaîne, elle recherche si la propriété Classe existe avec ce nom dans l’application. Si elle ne parvient pas à trouver une propriété de l’application, elle recherche une propriété dans le document avec ce nom et s’attend à ce que cette propriété se mappe à une classe.

Si le fournisseur de données est un objet E4X XML, vous devez définir explicitement cette propriété. Par exemple, utilisez @icon pour indiquer l’attribut icon.

La valeur par défaut est "icon".

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 iconFieldChanged .

Fonction qui détermine l’icône à afficher pour chaque élément de menu. Si vous omettez cette propriété, Flex utilise le contenu du champ ou de l’attribut déterminé par la propriété iconField. Si vous spécifiez cette propriété, Flex ignore toute valeur de la propriétéiconField.

Par défaut, le menu n’essaie pas d’afficher les icônes avec le texte dans les rangées. En revanche, en spécifiant une fonction d’icône, vous pouvez définir une classe pour un graphique qui sera créé et affiché en tant qu’icône dans la rangée.

La propriété iconFunction prend un unique argument correspondant à l’élément du fournisseur de données et renvoie une classe:

La valeur par défaut est null.

Nom du champ dans le tableau dataProvider qui contient le texte à afficher pour chaque élément de menu. La propriété labelFunction, si elle est définie, remplace cette propriété. Si le fournisseur de données est un tableau de chaînes, Flex utilise chaque valeur de chaîne comme étiquette. Si le fournisseur de données est un objet E4X XML, vous devez définir explicitement cette propriété. Par exemple, utilisez @label pour indiquer l’attribut label.

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 de chaque élément de menu. Si vous omettez cette propriété, Flex utilise le contenu du champ ou de l’attribut déterminé par la propriété labelField. Si vous spécifiez cette propriété, Flex ignore toute valeur de la propriété labelField.

Si vous spécifiez cette propriété, la fonction d’étiquette doit trouver le ou les champs appropriés et renvoyer une chaîne affichable. La propriété labelFunction permet de gérer la mise en forme et la localisation.

La propriété d’étiquette doit prendre un seul argument correspondant à l’élément du fournisseur de données et renvoyer une chaîne, comme l’illustre l’exemple suivant :

labelFunction(item:Object):String

La valeur par défaut est null.

Référence à l’objet de menu déroulant.

Cette propriété est en lecture seule et sa définition n’a aucun effet. Définissez plutôt la propriété dataProvider (l’indicateur d’écriture seule s’affiche dans le résumé de la syntaxe, car la propriété dans la super-classe est accessible en lecture et en écriture et cette classe remplace la méthode setter par une implémentation vide).

Indique si le ou les nœuds de niveau supérieur du fournisseur de données doivent être affichés. Si cette propriété est définie sur false, le contrôle n’affiche que les descendants du premier nœud de niveau supérieur. Tous les autres nœuds de niveau supérieur sont ignorés. Vous définissez généralement cette propriété sur false pour les fournisseurs de données XML au format E4X, dont le nœud de niveau supérieur est l’objet document.

La valeur par défaut est true.

Constructeur.

Distribué lorsqu’un utilisateur sélectionne un élément dans le menu contextuel.

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.