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 

IVisualElementContainer  - AS3 Flex

Paketmx.core
Schnittstellepublic interface IVisualElementContainer
Umsetzer Container, ContainerMovieClip, Group, Scroller, SkinnableContainer

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die IVisualElementContainer-Schnittstelle definiert die von einem Container für das Verwalten der Anzeige von Spark-Komponenten mindestens erforderlichen Eigenschaften und Methoden.

Beachten Sie, dass die Spark SkinnableDataContainer- und DataGroup-Container diese Schnittstelle nicht implementieren. Diese Container verwalten ihre untergeordneten Objekte mithilfe der dataProvider-Eigenschaft.

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  numElements : int
[schreibgeschützt] Die Anzahl an visuellen Elementen in diesem Container.
IVisualElementContainer
Öffentliche Methoden
 MethodeDefiniert von
  
Fügt diesem Container ein visuelles Element hinzu.
IVisualElementContainer
  
Fügt diesem Container ein visuelles Element hinzu.
IVisualElementContainer
  
Gibt das visuelle Element an der angegebenen Indexposition zurück.
IVisualElementContainer
  
Gibt die Indexposition eines visuellen Elements zurück.
IVisualElementContainer
  
Entfernt alle visuellen Elemente aus dem Container.
IVisualElementContainer
  
Entfernt das angegebene visuelle Element aus der Liste untergeordneter Elemente dieses Containers.
IVisualElementContainer
  
Entfernt ein visuelles Element von der angegebenen Indexposition im Container.
IVisualElementContainer
  
Ändert die Position eines vorhandenen visuellen Elements im visuellen Container.
IVisualElementContainer
  
Tauscht die Indexposition von zwei angegebenen visuellen Elementen aus.
IVisualElementContainer
  
swapElementsAt(index1:int, index2:int):void
Tauscht die visuellen Elemente an den beiden angegebenen Indexpositionen im Container aus.
IVisualElementContainer
Eigenschaftendetails

numElements

Eigenschaft
numElements:int  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Die Anzahl an visuellen Elementen in diesem Container. Visuelle Elemente enthalten Klassen, die die IVisualElement-Schnittstelle implementieren, z. B. Unterklassen von UIComponent und GraphicElement.



Implementierung
    public function get numElements():int
Methodendetails

addElement

()Methode
public function addElement(element:IVisualElement):IVisualElement

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Fügt diesem Container ein visuelles Element hinzu. Das Element wird nach allen anderen Elementen hinzugefügt und über allen anderen Elementen angezeigt. Mit der addElementAt()-Methode fügen Sie ein visuelles Element an einer bestimmten Indexposition hinzu.

Wenn Sie ein visuelles Element hinzufügen, das bereits einem anderen Container untergeordnet ist, wird es aus dem anderen Container entfernt.

Parameter

element:IVisualElement — Das visuelle Element, das als untergeordnetes Objekt dieses Containers hinzugefügt werden soll.

Rückgabewerte
IVisualElement — Das hinzugefügte Element.

Ereignisse
elementAdd:ElementExistenceEvent — Wird ausgelöst, wenn das Element der Child-Liste hinzugefügt wird.

Auslöser
ArgumentError — Wenn das Element dem visuellen Container entspricht.

addElementAt

()Methode 
public function addElementAt(element:IVisualElement, index:int):IVisualElement

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Fügt diesem Container ein visuelles Element hinzu. Das Element wird an der angegebenen Indexposition eingefügt. Die Indexposition 0 bezeichnet das erste Element der Anzeigeliste.

Wenn Sie ein visuelles Element hinzufügen, das bereits einem anderen Container untergeordnet ist, wird es aus dem anderen Container entfernt.

Parameter

element:IVisualElement — Das Element, das diesem Container als untergeordnetes Objekt hinzugefügt werden soll.
 
index:int — Die Indexposition, an der das Element hinzugefügt wird. Wenn Sie eine gerade besetzte Indexposition angeben, werden das untergeordnete Objekt an dieser Stelle sowie alle darüber liegenden Positionen innerhalb der Child-Liste um eine Position nach oben verschoben.

Rückgabewerte
IVisualElement — Das hinzugefügte Element.

Ereignisse
elementAdd:ElementExistenceEvent — Wird ausgelöst, wenn das Element der Child-Liste hinzugefügt wird.

Auslöser
ArgumentError — Wenn das Element dem Container entspricht.
 
RangeError — Wenn die Indexposition in der Child-Liste nicht vorhanden ist.

getElementAt

()Methode 
public function getElementAt(index:int):IVisualElement

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Gibt das visuelle Element an der angegebenen Indexposition zurück.

Parameter

index:int — Die Indexposition des abzurufenden Elements.

Rückgabewerte
IVisualElement — Das Element an der angegebenen Indexposition.

Auslöser
RangeError — Wenn die Indexposition in der Child-Liste nicht vorhanden ist.

getElementIndex

()Methode 
public function getElementIndex(element:IVisualElement):int

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Gibt die Indexposition eines visuellen Elements zurück.

Parameter

element:IVisualElement — Das visuelle Element.

Rückgabewerte
int — Die Indexposition des Elements im Container.

Auslöser
ArgumentError — Wenn das Element diesem visuellen Container nicht untergeordnet ist.

removeAllElements

()Methode 
public function removeAllElements():void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Entfernt alle visuellen Elemente aus dem Container.

removeElement

()Methode 
public function removeElement(element:IVisualElement):IVisualElement

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Entfernt das angegebene visuelle Element aus der Child-Liste dieses Containers. Die Indexpositionen aller Elemente über dem Element in diesem visuellen Container werden um 1 verringert.

Parameter

element:IVisualElement — Das aus dem Container zu entfernende Element.

Rückgabewerte
IVisualElement — Das Element, das entfernt wurde.

Auslöser
ArgumentError — Wenn der Elementparameter kein untergeordnetes Element dieses visuellen Containers ist.

removeElementAt

()Methode 
public function removeElementAt(index:int):IVisualElement

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Entfernt ein visuelles Element von der angegebenen Indexposition im Container. Die Indexpositionen aller Elemente über dem Element in diesem visuellen Container werden um 1 verringert.

Parameter

index:int — Die Indexposition des zu entfernenden Elements.

Rückgabewerte
IVisualElement — Das Element, das entfernt wurde.

Auslöser
RangeError — Wenn die Indexposition in der Child-Liste nicht vorhanden ist.

setElementIndex

()Methode 
public function setElementIndex(element:IVisualElement, index:int):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Ändert die Position eines vorhandenen visuellen Elements im visuellen Container.

Wenn Sie die setElementIndex()()-Methode verwenden und eine bereits belegte Indexposition angeben, werden nur die Positionen zwischen der alten und der neuen Position des Elements geändert. Alle anderen Positionen bleiben unverändert.

Wird ein visuelles Element an eine niedrigere Indexposition verschoben, erhöht sich die Indexposition aller Elemente zwischen der aktuellen und der neuen Position des Elements um 1. Wenn ein Element an eine Indexposition verschoben wird, die höher als die aktuelle Indexposition ist, wird die Indexposition von allen Elementen dazwischen um 1 verringert.

Parameter

element:IVisualElement — Das Element, dessen Indexpositionsnummer Sie ändern möchten.
 
index:int — Die resultierende Indexnummer für das Element.


Auslöser
RangeError — Wenn die Indexposition in der Child-Liste nicht vorhanden ist.
 
ArgumentError — Wenn der Elementparameter kein untergeordnetes Element dieses visuellen Containers ist.

swapElements

()Methode 
public function swapElements(element1:IVisualElement, element2:IVisualElement):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Tauscht die Indexposition von zwei angegebenen visuellen Elementen aus. Alle anderen Elemente bleiben an ihrer aktuellen Indexposition.

Parameter

element1:IVisualElement — Das erste visuelle Element.
 
element2:IVisualElement — Das zweite visuelle Element.

swapElementsAt

()Methode 
public function swapElementsAt(index1:int, index2:int):void

Sprachversion: ActionScript 3.0
Produktversion: Flex 4
Laufzeitversionen: Flash Player 10, AIR 1.5

Tauscht die visuellen Elemente an den beiden angegebenen Indexpositionen im Container aus. Alle anderen visuellen Elemente bleiben an ihrer aktuellen Indexposition.

Parameter

index1:int — Die Indexposition des ersten Elements.
 
index2:int — Die Indexposition des zweiten Elements.


Auslöser
RangeError — Wenn beide Indexpositionen im visuellen Container nicht vorhanden sind.




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