Présentation de la balise Collection
Utilisez la balise Collection pour décrire un tableau d'objets qui peuvent être modifiés en tant que collection d'éléments dans la boîte de dialogue Valeurs pendant la programmation.
Le type des objets est identifié par l'attribut collectionItem. Une propriété collection contient une série d'éléments de collection que vous définissez dans une classe séparée. Cette classe est mx.utils.CollectionImpl ou une sous-classe de cette classe. Vous accédez aux objets individuels à l'aide des méthodes de la classe identifiée par l'attribut collectionClass.
La syntaxe de la balise Collection est la suivante :
[Collection (name="name", variable="varname", collectionClass="mx.utils.CollectionImpl", collectionItem="coll-item-classname", identifier="string")] public var varname:mx.utils.Collection;
Le tableau suivant répertorie les attributs de la balise Collection :
|
Attribut |
Type |
Description |
|---|---|---|
| nom |
String |
(Obligatoire) Nom qui apparaît dans l'inspecteur des composants pour la collection. |
| variable |
String |
(Obligatoire) Variable ActionScript pointant vers l'objet Collection sous-jacent (par exemple, vous pouvez nommer un paramètre Collection Columns mais l'attribut variable sous-jacent peut être __columns). |
| collectionClass |
String |
(Obligatoire) Spécifie le type de classe à instancier pour la propriété de collection. Il s'agit généralement de mx.utils.CollectionImpl mais ce peut être également une classe qui étend mx.utils.CollectionImpl. |
| collectionItem |
String |
(Obligatoire) Spécifie la classe des éléments à stocker dans la collection. Cette classe comprend ses propres propriétés d'inspection exposées au moyen des métadonnées. |
| identifier |
String |
(Obligatoire) Spécifie le nom d'une propriété d'inspection dans la classe des éléments de collection que Flash utilise comme identifiant par défaut lorsque l'utilisateur ajoute un nouvel élément de collection dans la boîte de dialogue Valeurs. Chaque fois qu'un utilisateur crée un nouvel élément de collection, Flash MX définit le nom de l'élément sur identifier ainsi qu'un index unique (par exemple, si identifier=name, la boîte de dialogue Valeurs affiche name0, name1, name2, etc.). |
Pour plus d'informations, consultez la section Propriétés de collection.