Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
mx.core 

IVisualElementContainer  - AS3 Flex

Packagemx.core
Interfacepublic interface IVisualElementContainer
Implémenteurs Container, ContainerMovieClip, Group, Scroller, SkinnableContainer

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

L’interface IVisualElementContainer définit les propriétés et les méthodes minimales nécessaires à un conteneur pour gérer l’affichage des composants Spark.

Notez que les conteneurs DataGroup et SkinnableDataContainer Spark n’implémentent pas cette interface. Ces conteneurs gèrent leurs enfants via la propriété dataProvider.

Eléments de l’API associés



Propriétés publiques
 PropriétéDéfini par
  numElements : int
[lecture seule] Nombre d’éléments visuels dans ce conteneur.
IVisualElementContainer
Méthodes publiques
 MéthodeDéfini par
  
Ajoute un élément visuel à ce conteneur.
IVisualElementContainer
  
Ajoute un élément visuel à ce conteneur.
IVisualElementContainer
  
Renvoie l’élément visuel à l’index spécifié.
IVisualElementContainer
  
Renvoie la position d’index d’un élément visuel.
IVisualElementContainer
  
Supprime tous les éléments visuels du conteneur.
IVisualElementContainer
  
Supprime l’élément visuel spécifié de la liste des enfants de ce conteneur.
IVisualElementContainer
  
Supprime un élément visuel du conteneur, à la position d’index spécifiée.
IVisualElementContainer
  
Modifie la position d’un élément visuel existant dans le conteneur visuel.
IVisualElementContainer
  
Intervertit l’index des deux éléments visuels spécifiés.
IVisualElementContainer
  
swapElementsAt(index1:int, index2:int):void
Intervertit les éléments visuels qui se trouvent aux deux positions d’index spécifiées dans le conteneur.
IVisualElementContainer
Détails de la propriété

numElements

propriété
numElements:int  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Nombre d’éléments visuels dans ce conteneur. Les éléments visuels comprennent des classes qui implémentent l’interface IVisualElement, tels que les sous-classes de UIComponent et GraphicElement.



Implémentation
    public function get numElements():int
Détails de la méthode

addElement

()méthode
public function addElement(element:IVisualElement):IVisualElement

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Ajoute un élément visuel à ce conteneur. L’élément est ajouté après tous les autres éléments, au-dessus de ces derniers pour ajouter un élément visuel à une position d’index spécifique, utilisez la méthode addElementAt().

Si vous ajoutez un élément visuel qui possède déjà un autre conteneur différent comme parent, il est supprimé de l’autre conteneur.

Paramètres

element:IVisualElement — Elément visuel à ajouter en tant qu’enfant de ce conteneur.

Valeur renvoyée
IVisualElement — Elément ajouté.

Evénements
elementAdd:ElementExistenceEvent — Distribué lorsque l’élément est ajouté à la liste d’enfants.

Valeur émise
ArgumentError — Si l’élément est le même que le conteneur visuel.

addElementAt

()méthode 
public function addElementAt(element:IVisualElement, index:int):IVisualElement

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Ajoute un élément visuel à ce conteneur. L’élément est placé à la position d’index spécifiée. La position d’index 0 représente le premier élément de la liste d’affichage.

Si vous ajoutez un élément visuel qui possède déjà un autre conteneur différent comme parent, il est supprimé de l’autre conteneur.

Paramètres

element:IVisualElement — Elément à ajouter en tant qu’enfant de ce conteneur visuel.
 
index:int — Position d’index à laquelle est ajouté l’élément. Si vous spécifiez une position d’index actuellement occupée, l’enfant associé à cette position et toutes les positions supérieures sont décalés d’une position vers le haut dans la liste des enfants.

Valeur renvoyée
IVisualElement — Elément ajouté.

Evénements
elementAdd:ElementExistenceEvent — Distribué lorsque l’élément est ajouté à la liste d’enfants.

Valeur émise
ArgumentError — Si l’élément est le même que le conteneur.
 
RangeError — Si la position d’index n’existe pas dans la liste des enfants.

getElementAt

()méthode 
public function getElementAt(index:int):IVisualElement

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Renvoie l’élément visuel à l’index spécifié.

Paramètres

index:int — Index de l’élément à récupérer.

Valeur renvoyée
IVisualElement — Elément présent à l’index spécifié.

Valeur émise
RangeError — Si la position d’index n’existe pas dans la liste des enfants.

getElementIndex

()méthode 
public function getElementIndex(element:IVisualElement):int

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Renvoie la position d’index d’un élément visuel.

Paramètres

element:IVisualElement — Elément visuel.

Valeur renvoyée
int — Position d’index de l’élément dans le conteneur.

Valeur émise
ArgumentError — Si l’élément n’est pas un enfant de ce conteneur visuel.

removeAllElements

()méthode 
public function removeAllElements():void

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Supprime tous les éléments visuels du conteneur.

removeElement

()méthode 
public function removeElement(element:IVisualElement):IVisualElement

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Supprime l’élément visuel spécifié de la liste des enfants de ce conteneur. Les positions d’index de tout élément au-dessus de l’élément de ce conteneur visuel sont diminuées d’une unité.

Paramètres

element:IVisualElement — Elément à supprimer du conteneur.

Valeur renvoyée
IVisualElement — Elément supprimé.

Valeur émise
ArgumentError — Si le paramètre d’élément n’est pas un enfant de ce conteneur visuel.

removeElementAt

()méthode 
public function removeElementAt(index:int):IVisualElement

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Supprime un élément visuel du conteneur, à la position d’index spécifiée. Les positions d’index de tout élément au-dessus de l’élément de ce conteneur visuel sont diminuées d’une unité.

Paramètres

index:int — Index de l’élément à supprimer.

Valeur renvoyée
IVisualElement — Elément supprimé.

Valeur émise
RangeError — Si l’index n’existe pas dans la liste d’enfants.

setElementIndex

()méthode 
public function setElementIndex(element:IVisualElement, index:int):void

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Modifie la position d’un élément visuel existant dans le conteneur visuel.

Lorsque vous appelez la méthode setElementIndex() et spécifiez une position d’index déjà occupée, les seules positions qui changent sont celles situées entre l’ancienne et la nouvelle position de l’élément. Toutes les autres positions restent identiques.

Si un élément visuel est déplacé vers un index inférieur à son index actuel, l’index de tous les éléments entre les deux augmente de 1. Si un élément est déplacé vers un index supérieur à son index actuel, l’index de tous les éléments situés entre l’ancienne position et la nouvelle position diminue d’une unité.

Paramètres

element:IVisualElement — Elément dont vous voulez modifier le numéro d’index.
 
index:int — Nouveau numéro d’index de l’élément.


Valeur émise
RangeError — Si l’index n’existe pas dans la liste d’enfants.
 
ArgumentError — Si le paramètre d’élément n’est pas un enfant de ce conteneur visuel.

swapElements

()méthode 
public function swapElements(element1:IVisualElement, element2:IVisualElement):void

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Intervertit l’index des deux éléments visuels spécifiés. Tous les autres éléments gardent la même position d’index.

Paramètres

element1:IVisualElement — Premier élément visuel.
 
element2:IVisualElement — Deuxième élément visuel.

swapElementsAt

()méthode 
public function swapElementsAt(index1:int, index2:int):void

Version du langage: ActionScript 3.0
Version du produit: Flex 4
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Intervertit les éléments visuels qui se trouvent aux deux positions d’index spécifiées dans le conteneur. Tous les autres éléments visuels gardent la même position d’index.

Paramètres

index1:int — Index du premier élément.
 
index2:int — Index du second élément.


Valeur émise
RangeError — Si l’un ou l’autre des index n’existe pas dans le conteneur visuel.




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.