ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.core 

IRepeater  - AS3 Flex

Paketmx.core
Schnittstellepublic interface IRepeater
Umsetzer Repeater

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die IRepeater-Schnittstelle definiert die öffentlichen APIs des Repeater-Objekts.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  container : IContainer
[schreibgeschützt] Der Container, der diesen Repeater enthält und in dem dieser seine untergeordneten Elemente erstellen wird.
IRepeater
  count : int
Die Anzahl der Ausführungen für diesen Repeater.
IRepeater
  currentIndex : int
[schreibgeschützt] Die Indexposition des Elements im dataProvider, das gerade verarbeitet wird, während dieser Repeater ausgeführt wird.
IRepeater
  currentItem : Object
[schreibgeschützt] Das Element im dataProvider, das gerade verarbeitet wird, während dieser Repeater ausgeführt wird.
IRepeater
  dataProvider : Object
Der von diesem Repeater zum Erstellen wiederholter Instanzen seiner untergeordneten Elemente verwendete Datenprovider.
IRepeater
  recycleChildren : Boolean
Ein boolesches Flag, das anzeigt, ob dieser Repeater zuvor erstellte untergeordnete Elemente wiederverwenden oder neu erstellen soll.
IRepeater
  startingIndex : int
Die Indexposition im dataProvider, an der dieser Repeater mit der Erstellung von untergeordneten Elementen beginnt.
IRepeater
Öffentliche Methoden
 MethodeDefiniert von
  
Führt die Bindungen in alle von diesem Repeater erstellten UIComponents aus.
IRepeater
  
Initialisiert ein neues Repeater-Objekt.
IRepeater
Eigenschaftendetails

container

Eigenschaft
container:IContainer  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Der Container, der diesen Repeater enthält und in dem dieser seine untergeordneten Elemente erstellen wird.



Implementierung
    public function get container():IContainer

count

Eigenschaft 
count:int

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Anzahl der Ausführungen für diesen Repeater.

Wenn der Repeater während des Ausführens das Ende des Datenproviders erreicht, liegt die Anzahl der tatsächlichen Ausführungen unter der angeforderten Anzahl.



Implementierung
    public function get count():int
    public function set count(value:int):void

currentIndex

Eigenschaft 
currentIndex:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Indexposition des Elements im dataProvider, das gerade verarbeitet wird, während dieser Repeater ausgeführt wird.

Nach Abschluss der Ausführung des Repeaters hat diese Eigenschaft den Wert -1. Die repeaterIndex-Eigenschaft einer wiederholten Komponenteninstanz merkt sich jedoch die Indexposition des dataProvider-Elements, von dem aus sie erstellt wurde. Im Fass von verschachtelten Repeatern können Sie das repeaterIndices-Array verwenden.



Implementierung
    public function get currentIndex():int

Verwandte API-Elemente

currentItem

Eigenschaft 
currentItem:Object  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das Element im dataProvider, das gerade verarbeitet wird, während dieser Repeater ausgeführt wird.

Nach Abschluss der Ausführung des Repeaters hat diese Eigenschaft den Wert null. In diesem Fall können Sie jedoch die getRepeaterItem()-Methode der wiederholten Komponenteninstanz aufrufen, um das dataProvider-Element abzurufen, von dem aus sie erstellt wurde.



Implementierung
    public function get currentItem():Object

Verwandte API-Elemente

dataProvider

Eigenschaft 
dataProvider:Object

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Der von diesem Repeater zum Erstellen wiederholter Instanzen seiner untergeordneten Elemente verwendete Datenprovider.

Wenn Sie die dataProvider-Eigenschaft auslesen, erhalten Sie immer ein ICollectionView-Objekt oder null. Wenn Sie die dataProvider-Eigenschaft auf einen anderen Wert als null setzen, wird sie entsprechend der folgenden Regeln in ein ICollectionView-Objekt konvertiert:

  • Wenn Sie sie auf ein Array einstellen, wird sie in eine ArrayCollection konvertiert.
  • Wenn Sie sie auf eine ICollectionView einstellen, erfolgt keine Konvertierung.
  • Wenn Sie sie auf ein IList einstellen, wird sie in eine ListCollectionView konvertiert.
  • Wenn Sie sie auf ein XML oder eine XMLList einstellen, wird sie in eine XMLListCollection konvertiert.
  • In allen anderen Fällen wird sie in eine ArrayCollection mit einem einzelnen Element konvertiert.

Sie müssen einen Wert für die dataProvider-Eigenschaft angeben, damit die Repeater-Komponente ausgeführt wird.



Implementierung
    public function get dataProvider():Object
    public function set dataProvider(value:Object):void

recycleChildren

Eigenschaft 
recycleChildren:Boolean

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Ein boolesches Flag, das anzeigt, ob dieser Repeater zuvor erstellte untergeordnete Elemente wiederverwenden oder neu erstellen soll.

Ist der Wert hierfür true, verwendet dieser Repeater, wenn sich sein dataProvider, startingIndex oder count ändert, vorhandene untergeordnete Elemente wieder, indem er die neue Daten daran bindet. Sind mehr untergeordnete Elemente erforderlich, werden sie erstellt und hinzugefügt. Sind weniger untergeordnete Elemente erforderlich, werden die überzähligen Elemente entfernt und vom Garbagekollektor aus dem Speicher bereinigt.

Ist der Wert hierfür false, entfernt dieser Repeater, wenn sich sein dataProvider, startingIndex oder count ändert, alle zuvor erstellten untergeordneten Elemente und erstellt ausgehend von den neuen Datenelementen neue untergeordnete Elemente und fügt diese hinzu.

Diese Eigenschaft hat den Standardwert false. Die Einstellung true führt dazu, dass die Leistung steigt, ist jedoch nicht immer empfehlenswert. Beispiel: Wenn die zuvor erstellten untergeordneten Elemente Statusinformationen wie durch einen Benutzer eingegebenen Text enthalten, wird dieser Status bei Wiederverwendung der untergeordneten Elemente nicht zurückgesetzt.



Implementierung
    public function get recycleChildren():Boolean
    public function set recycleChildren(value:Boolean):void

startingIndex

Eigenschaft 
startingIndex:int

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Die Indexposition im dataProvider, an der dieser Repeater mit der Erstellung von untergeordneten Elementen beginnt.



Implementierung
    public function get startingIndex():int
    public function set startingIndex(value:int):void
Methodendetails

executeChildBindings

()Methode
public function executeChildBindings():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Führt die Bindungen in alle von diesem Repeater erstellten UIComponents aus.

Diese Methode wird vom Flex-Framework aufgerufen. Entwickler brauchen sie im Normalfall nicht aufzurufen.

initializeRepeater

()Methode 
public function initializeRepeater(container:IContainer, recurse:Boolean):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Initialisiert ein neues Repeater-Objekt.

Diese Methode wird vom Flex-Framework aufgerufen. Entwickler brauchen sie im Normalfall nicht aufzurufen.

Parameter

container:IContainer — Der Container, der diesen Repeater enthält und in dem dieser Repeater seine untergeordneten Elemente erstellen wird.
 
recurse:Boolean — Ein boolesches Flag, das anzeigt, ob dieser Repeater alle untergeordneten Elemente seiner untergeordneten Elemente erstellen soll.





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.