Package | mx.core |
Interface | public interface IChildList |
Implémenteurs | Container, SystemManager, UIComponent |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Par exemple, considérez la classe Container. Elle remplace les API DisplayObjectContainer telles que les méthodes numChildren
et getChildAt()
pour l’accès aux seuls enfants de « contenu », correspondant aux commandes et autres conteneurs placés dans celles-ci. Mais un conteneur peut également comprendre des enfants supplémentaires créés automatiquement par la structure, par exemple un habillage d’arrière-plan ou de bordure, ainsi que des barres de défilement. Ainsi, la classe Container expose une propriété du type IChildList appelée rawChildren
, permettant d’accéder à tous ses enfants, et non seulement aux enfants de contenu.
A titre d’autre exemple, la classe SystemManager est un objet DisplayObjectContainer dont les enfants sont répartis sur différents calques : les enfants normaux comme l’application figurent en dessous, puis viennent les fenêtres contextuelles, puis les infos-bulles, enfin les curseurs figurent tout en haut. La classe SystemManager dispose de propriétés nommées popUpChildren
, toolTipChildren
et cursorChildren
permettant d’accéder à ces calques. Toutes ces propriétés sont de type IChildList. Par conséquent, vous pouvez compter le nombre de fenêtres contextuelles à l’aide de la propriété systemManager.popUpChildren.numChildren
, insérer un autre objet DisplayObject dans le calque d’info-bulle à l’aide de la méthode systemManager.toolTipChildren.addChild()
et ainsi de suite.
Eléments de l’API associés
mx.managers.SystemManager.rawChildren
mx.managers.SystemManager.popUpChildren
mx.managers.SystemManager.toolTipChildren
mx.managers.SystemManager.cursorChildren
Propriété | Défini par | ||
---|---|---|---|
numChildren : int [lecture seule]
Nombre d’enfants dans cette liste d’enfants. | IChildList |
Méthode | Défini par | ||
---|---|---|---|
Ajoute un objet DisplayObject enfant à la fin de la liste d’enfants. | IChildList | ||
Ajoute une instance enfant de DisplayObject à cette liste d’enfants à l’index spécifié. | IChildList | ||
Détermine si un objet DisplayObject figure dans cette liste d’enfants ou est un descendant d’un enfant de cette liste d’enfants. | IChildList | ||
Obtient l’objet DisplayObject enfant qui se trouve à la position d’index spécifiée de cette liste d’enfants. | IChildList | ||
Obtient l’objet DisplayObject enfant avec le nom spécifié dans cette liste d’enfants. | IChildList | ||
Récupère la position d’index d’un enfant spécifique dans cette liste d’enfants. | IChildList | ||
Renvoie un tableau d’objets DisplayObject de niveau inférieur au point spécifié et figurant dans cette liste d’enfants. | IChildList | ||
Supprime l’objet DisplayObject enfant spécifié de cette liste d’enfants. | IChildList | ||
Supprime l’objet DisplayObject enfant qui se trouve à l’index spécifié de cette liste d’enfants. | IChildList | ||
Modifie la position d’index d’un enfant particulier de cette liste d’enfants. | IChildList |
numChildren | propriété |
addChild | () | méthode |
public function addChild(child:DisplayObject):DisplayObject
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Ajoute un objet DisplayObject enfant à la fin de la liste d’enfants.
Le résultat des méthodes childList.addChild(child)
et childList.addChild(child, childList.numChildren)
est identique. Une fois l’enfant ajouté, son index est (child.numChildren - 1)
.
Paramètres
child:DisplayObject — Objet DisplayObject à ajouter comme enfant.
|
DisplayObject — Enfant ajouté. Correspond à l’argument transmis.
|
addChildAt | () | méthode |
public function addChildAt(child:DisplayObject, index:int):DisplayObject
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Ajoute une instance enfant de DisplayObject à cette liste d’enfants à l’index spécifié. La position d’index 0 représente le début de la liste DisplayList et la position d’index numChildren
représente la valeur de fin.
L’ajout d’un enfant à toute position, sauf à la fin d’une liste d’enfants, incrémente les index des enfants précédemment situés à cette position d’index ou à des indices supérieurs.
Paramètres
child:DisplayObject — Objet DisplayObject à ajouter comme enfant.
| |
index:int — Index à laquelle ajouter l’enfant.
|
DisplayObject — Enfant ajouté. Correspond à l’argument child transmis en entrée.
|
contains | () | méthode |
public function contains(child:DisplayObject):Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Détermine si un objet DisplayObject figure dans cette liste d’enfants ou est un descendant d’un enfant de cette liste d’enfants.
Paramètres
child:DisplayObject — Objet DisplayObject à tester.
|
Boolean — true si l’objet DisplayObject figure dans cette liste d’enfants ou est un descendant d’un enfant de cette liste d’enfants ; false dans le cas contraire.
|
getChildAt | () | méthode |
public function getChildAt(index:int):DisplayObject
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient l’objet DisplayObject enfant qui se trouve à la position d’index spécifiée de cette liste d’enfants.
Paramètres
index:int — Entier compris entre 0 et (numChildren - 1) qui spécifie la position d’index d’un enfant de cette liste d’enfants.
|
DisplayObject — Enfant à l’index spécifié.
|
getChildByName | () | méthode |
public function getChildByName(name:String):DisplayObject
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Obtient l’objet DisplayObject enfant avec le nom spécifié dans cette liste d’enfants.
Paramètres
name:String — Nom de l’enfant à renvoyer.
|
DisplayObject — Enfant portant le nom spécifié.
|
getChildIndex | () | méthode |
public function getChildIndex(child:DisplayObject):int
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Récupère la position d’index d’un enfant spécifique dans cette liste d’enfants.
Le premier enfant dans la liste d’enfants a un index de 0, le deuxième enfant a un index de 1, et le dernier enfant a un index de (numChildren - 1)
.
Si getChildIndex(myChild)
renvoie 5, alors myView.getChildAt(5)
renvoie myChild
.
Si vous ajoutez un enfant en appelant la méthode addChild()
, la position d’index du nouvel enfant est égale à la plus grande position d’index parmi les enfants existants plus un.
Vous pouvez insérer un enfant à une position d’index spécifiée à l’aide de la méthode addChildAt()
. Dans ce cas, les enfants précédemment à cette position d’index et aux indices supérieurs ont leur position d’index augmentée de 1 pour que tous les enfants soient indexés entre 0 et (numChildren - 1)
.
Si vous supprimez un enfant en appelant les méthodes removeChild()
ou removeChildAt()
, les enfants des indices supérieurs ont leur position d’index diminuée de 1 pour que tous les enfants soient indexés entre 0 et (numChildren - 1)
.
Si vous modifiez la position d’index d’un enfant en appelant la méthode setChildIndex()
, les positions d’index des enfants situés entre l’ancienne position d’index et la nouvelle (incluse) sont ajustées pour que tous les enfants soient indexés entre 0 et (numChildren - 1)
.
Paramètres
child:DisplayObject — Enfant portant la position d’index à obtenir.
|
int — Position d’index de l’enfant, correspondant à un entier compris entre 0 et (numChildren - 1) .
|
getObjectsUnderPoint | () | méthode |
public function getObjectsUnderPoint(point:Point):Array
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie un tableau d’objets DisplayObject de niveau inférieur au point spécifié et figurant dans cette liste d’enfants.
Paramètres
point:Point — Le point sous lequel sont extraits les objets.
|
Array — Tableau d’objets de niveau inférieur au point spécifié qui sont des enfants de ce conteneur.
|
removeChild | () | méthode |
public function removeChild(child:DisplayObject):DisplayObject
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime l’objet DisplayObject enfant spécifié de cette liste d’enfants.
La suppression d’un enfant ailleurs qu’à la fin d’une liste d’enfants décrémente les index des enfants d’index supérieur.
Le parent de l’enfant supprimé est défini sur null et l’enfant fait l’objet d’une récupération de place si plus aucun élément n’y fait référence.
Paramètres
child:DisplayObject — Objet DisplayObject à supprimer.
|
DisplayObject — Enfant supprimé. Correspond à l’argument transmis.
|
removeChildAt | () | méthode |
public function removeChildAt(index:int):DisplayObject
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Supprime l’objet DisplayObject enfant qui se trouve à l’index spécifié de cette liste d’enfants.
La suppression d’un enfant ailleurs qu’à la fin d’une liste d’enfants décrémente les index des enfants d’index supérieur.
Le parent de l’enfant supprimé est défini sur null et l’enfant fait l’objet d’une récupération de place si plus aucun élément n’y fait référence.
Paramètres
index:int — Index enfant de l’objet DisplayObject à supprimer.
|
DisplayObject — Enfant supprimé.
|
setChildIndex | () | méthode |
public function setChildIndex(child:DisplayObject, newIndex:int):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Modifie la position d’index d’un enfant particulier de cette liste d’enfants. Voir la méthode getChildIndex()
pour une description de l’index de l’enfant.
Paramètres
child:DisplayObject — Enfant pour lequel définir la position d’index.
| |
newIndex:int — Nouvel index pour l’enfant spécifié. Il doit correspondre à un entier compris entre zéro et (numChildren - 1) .
|
Tue Jun 12 2018, 09:30 AM Z