| Package | mx.core |
| Classe | public class UIComponentDescriptor |
| Héritage | UIComponentDescriptor  ComponentDescriptor Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
La plupart des balises d’un fichier MXML décrivent une arborescence d’objets UIComponent. Par exemple, la balise <mx:Application> représente un objet UIComponent et ses commandes et conteneurs enfant sont tous des objets UIComponent.
Le compilateur MXML compile chacune de ces balises MXML dans une instance UIComponentDescriptor. Pour être précis, le compilateur MXML génère automatiquement une structure de données ActionScript qui correspond à une arborescence d’objets UIComponentDescriptor.
Lors de l’exécution, la méthode createComponentsFromDescriptors() de la classe Container utilise les informations des objets UIComponentDescriptor dans le tableau childDescriptorsdu conteneur pour créer les objets UIComponent réels qui sont les enfants du conteneur, ainsi que des descendants plus éloignés. Selon la valeur de la propriété creationPolicy du conteneur, les descendants peuvent être créés au démarrage de l’application, lorsqu’une partie du composant est sur le point de devenir visible, ou lorsque le développeur de l’application appelle manuellement la méthode createComponentsFromDescriptors().
Généralement, il n’est pas nécessaire de créer les instances UIComponentDescriptor manuellement. Vous pouvez accéder à celles que le compilateur MXML génère automatiquement via le tableau childDescriptors de la classe Container.
Eléments de l’API associés
mx.core.Container.creationPolicy
mx.core.Container.createComponentsFromDescriptors()
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| document : Object
Référence à l’objet de document dans lequel le composant doit être créé. | ComponentDescriptor | |
| effects : Array
Tableau contenant les effets pour le composant, tels que spécifiés dans le code MXML. | UIComponentDescriptor | ||
| events : Object
Objet contenant des paires nom/valeur pour les gestionnaires d’événement du composant, tels que spécifiés dans le code MXML. | ComponentDescriptor | |
| id : String
Identifiant du composant, tel que spécifié dans le code MXML. | ComponentDescriptor | |
| properties : Object [lecture seule]
Objet contenant des paires nom/valeur pour les propriétés du composant, telles que spécifiées dans le code MXML. | ComponentDescriptor | |
| propertiesFactory : Function
Fonction qui renvoie un objet contenant des paires nom/valeur pour les propriétés du composant, telles que spécifiées dans le code MXML. | ComponentDescriptor | |
| stylesFactory : Function
Fonction qui construit un objet contenant des paires nom/valeur pour les styles hérités du composant, tels que spécifiés dans le code MXML. | UIComponentDescriptor | ||
| type : Class
Classe du composant, telle que spécifiée dans le code MXML. | ComponentDescriptor | |
| Méthode | Défini par | ||
|---|---|---|---|
UIComponentDescriptor(descriptorProperties:Object)
Constructeur. | UIComponentDescriptor | ||
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Invalide la propriété properties mise en cache. | ComponentDescriptor | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la chaîne « ComponentDescriptor_ » plus la valeur de la propriété id. | ComponentDescriptor | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
effects | propriété |
public var effects:Array| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Tableau contenant les effets pour le composant, tels que spécifiés dans le code MXML.
Si, par exemple, vous écrivez le code suivant :
<mx:TextInput showEffect="Fade" hideEffect="Fade"/>
La propriété effects du descripteur est le tableau [ "showEffect", "hideEffect" ].
La propriété effects a la valeur null si aucun effet MXML n’est spécifié pour le composant.
Notez que les valeurs des attributs d’effet ne sont pas spécifiées dans cette propriété. Au lieu de cela, les effets sont traités comme des styles et sont donc inclus dans la propriété stylesFactory. Le tableau effect conserve une liste des styles de la propriété stylesFactory qui sont réellement des effets.
Cette propriété est utilisée par la méthode createComponentsFromDescriptors() pour enregistrer les effets dans le gestionnaire EffectManager.
stylesFactory | propriété |
public var stylesFactory:Function| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Fonction qui construit un objet contenant des paires nom/valeur pour les styles hérités du composant, tels que spécifiés dans le code MXML.
Si, par exemple, vous écrivez le code suivant :
<mx:TextInput borderColor="0x888888" color="0xDDDDDD"/>
alors la propriété stylesFactory du descripteur est la fonction :
function():void { this.borderColor = 0x888888; this.color = 0xDDDDDD };
La propriété stylesFactory a la valeur null si aucun style MXML n’est spécifié pour l’instance du composant.
UIComponentDescriptor | () | Constructeur |
public function UIComponentDescriptor(descriptorProperties:Object)| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
ParamètresdescriptorProperties:Object — Objet contenant des paires nom/valeur pour les propriétés de l’objet UIComponentDescriptor, telles que type, id, propertiesFactory, events, stylesFactory et effects.
|
Tue Jun 12 2018, 09:30 AM Z