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 

IRepeater  - AS3 Flex

Packagemx.core
Interfacepublic interface IRepeater
Implémenteurs Repeater

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

L’interface IRepeater définit les API publiques de l’objet Repeater.



Propriétés publiques
 PropriétéDéfini par
  container : IContainer
[lecture seule] Conteneur qui contient cet objet Repeater et dans lequel cet objet crée ses enfants.
IRepeater
  count : int
Nombre d’exécutions de cet objet Repeater.
IRepeater
  currentIndex : int
[lecture seule] Position d’index de l’élément dans le fournisseur dataProvider en cours de traitement lors de l’exécution de cet objet Repeater.
IRepeater
  currentItem : Object
[lecture seule] Elément dans le fournisseur dataProvider en cours de traitement lors de l’exécution de cet objet Repeater.
IRepeater
  dataProvider : Object
Fournisseur de données utilisé par cet objet Repeater pour créer des instances répétées de ses enfants.
IRepeater
  recycleChildren : Boolean
Indicateur à valeur booléenne indiquant si ce composant Repeater doit réutiliser des enfants créés précédemment ou en créer de nouveaux.
IRepeater
  startingIndex : int
Position d’index dans l’élément dataProvider à laquelle ce composant Repeater commence la création d’enfants.
IRepeater
Méthodes publiques
 MéthodeDéfini par
  
Exécute les liaisons dans tous les composants UIComponent créés par ce composant Repeater.
IRepeater
  
Initialise un nouvel objet Repeater.
IRepeater
Détails de la propriété

container

propriété
container:IContainer  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Conteneur qui contient cet objet Repeater et dans lequel cet objet crée ses enfants.



Implémentation
    public function get container():IContainer

count

propriété 
count:int

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Nombre d’exécutions de cet objet Repeater.

Si l’objet Repeater atteint la fin du fournisseur de données lors de l’exécution, le nombre effectif d’exécutions est inférieur au nombre demandé.



Implémentation
    public function get count():int
    public function set count(value:int):void

currentIndex

propriété 
currentIndex:int  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Position d’index de l’élément dans le fournisseur dataProvideren cours de traitement lors de l’exécution de cet objet Repeater.

Lorsque l’exécution de l’objet Repeater est terminée, cette propriété a la valeur -1. Toutefois, la propriété repeaterIndex d’une instance de composant répété mémorise la position d’index de l’élément dataProvider à partir duquel il a été créé. Dans le cas d’objets Repeater imbriqués, vous pouvez utiliser le tableau repeaterIndices.



Implémentation
    public function get currentIndex():int

Eléments de l’API associés

currentItem

propriété 
currentItem:Object  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Elément dans le fournisseur dataProvider en cours de traitement lors de l’exécution de cet objet Repeater.

Lorsque l’exécution de l’objet Repeater est terminée, cette propriété a la valeur null. Dans ce cas, vous pouvez toutefois appeler la méthode getRepeaterItem() de l’instance du composant répété pour obtenir l’élément dataProvider à partir duquel il a été créé.



Implémentation
    public function get currentItem():Object

Eléments de l’API associés

dataProvider

propriété 
dataProvider:Object

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Fournisseur de données utilisée par cet objet Repeater pour créer des instances répétées de ses enfants.

Si vous lisez la propriété dataProvider, vous obtenez toujours un objet ICollectionView ou null. Si vous définissez la propriété dataProvider sur une valeur différente de null, elle est converti en objet ICollectionView selon les règles suivantes :

  • Si vous la définissez sur un objet Array, elle est convertie en ensemble ArrayCollection.
  • Si vous la définissez sur une vue ICollectionView, aucune conversion n’est effectuée.
  • Si vous la définissez sur une liste IList, elle est convertie en vue ListCollectionView.
  • Si vous la définissez sur un objet XML ou XMLList, elle est convertie en ensemble XMLListCollection.
  • Dans le cas contraire, elle est convertie en un ensemble ArrayCollection avec un élément unique.

Vous devez spécifier une valeur pour la propriété dataProvider afin de permettre l’exécution du composant Repeater.



Implémentation
    public function get dataProvider():Object
    public function set dataProvider(value:Object):void

recycleChildren

propriété 
recycleChildren:Boolean

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Indicateur à valeur booléenne indiquant si ce composant Repeater doit réutiliser des enfants créés précédemment ou en créer de nouveaux.

Si la valeur est true, si la propriété dataProvider, startingIndex ou count du composant Repeater est modifiée, il recycle les enfants existants en leur reliant les nouvelles données. Si plus d’enfants sont nécessaires, ils sont créés et ajoutés. Si moins d’enfants sont nécessaires, les enfants en trop sont supprimés et nettoyés.

Si la valeur est false, si la propriété dataProvider, startingIndex ou count du composant Repeater est modifiée, il supprime les enfants qu’il a éventuellement créés, puis crée et ajoute de nouveaux enfants à partir des nouveaux éléments de données.

Par défaut, cette propriété a la valeur false. Sa définition sur true permet d’améliorer les performances, mais n’est pas adaptée dans tous les cas. Par exemple, si les enfants créés précédemment comportent des informations sur l’état tel que le texte saisi par un utilisateur, alors cet état n’est pas réinitialisé lorsque les enfants sont recyclés.



Implémentation
    public function get recycleChildren():Boolean
    public function set recycleChildren(value:Boolean):void

startingIndex

propriété 
startingIndex:int

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Position d’index dans l’élément dataProvider à laquelle ce composant Repeater commence la création d’enfants.



Implémentation
    public function get startingIndex():int
    public function set startingIndex(value:int):void
Détails de la méthode

executeChildBindings

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

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Exécute les liaisons dans tous les composants UIComponent créés par ce composant Repeater.

Cette méthode est appelée par la structure Flex. Les développeurs ne doivent pas nécessairement l’appeler.

initializeRepeater

()méthode 
public function initializeRepeater(container:IContainer, recurse:Boolean):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Initialise un nouvel objet Repeater.

Cette méthode est appelée par la structure Flex. Les développeurs ne doivent pas nécessairement l’appeler.

Paramètres

container:IContainer — Conteneur qui contient cet objet Repeater et dans lequel cet objet crée ses enfants.
 
recurse:Boolean — Indicateur à valeur booléenne indiquant si l’objet Repeater doit créer tous les descendants de ses enfants.





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