IContainer  - AS3 Flex

Legt den Schaltflächenmodus für dieses Sprite fest. Wenn true eingestellt ist, verhält sich dieses Sprite wie eine Schaltfläche. Dies bedeutet, dass die Anzeige des Handcursors ausgelöst wird, wenn der Zeiger über das Sprite bewegt wird, und ein click-Ereignis empfangen werden kann, wenn die Eingabe- oder Leertaste gedrückt wird, während das Sprite den Fokus besitzt. Sie können die Anzeige des Handcursors unterdrücken, indem Sie die useHandCursor-Eigenschaft auf false setzen. In diesem Fall wird der Pfeilcursor angezeigt.

Obwohl es besser ist, für die Erstellung von Schaltflächen die SimpleButton-Klasse zu verwenden, können Sie die buttonMode-Eigenschaft nutzen, um einem Sprite eine schaltflächenähnliche Funktionalität zu verleihen. Um ein Sprite in die Tabulatorreihenfolge einzubinden, setzen Sie die tabEnabled-Eigenschaft (wurde von der InteractiveObject-Klasse geerbt und ist standardmäßig auf false gesetzt) auf true. Zudem sollten Sie sich überlegen, ob die dem Sprite untergeordneten Objekte per Benutzereingabe aktivierbar sein sollen. Bei den meisten Schaltflächen ist für die untergeordneten Objekte keine Benutzereingabeinteraktivität aktiviert, da dies beim Ereignisablauf zu Verwirrung führen kann. Um die Benutzereingabeinteraktivität für alle untergeordneten Objekte zu aktivieren, müssen Sie die mouseChildren-Eigenschaft auf false setzen (wird von der DisplayObjectContainer-Klasse übernommen).

Wenn Sie die buttonMode-Eigenschaft mit der MovieClip-Klasse verwenden (die eine Unterklasse der Sprite-Klasse ist), kann es sein, dass Ihre Schaltfläche zusätzliche Funktionen besitzt. Wenn Sie die Bilder mit den Bezeichnungen „_up“ (auf), „_over“ (darüber) und „_down“ (gedrückt) einschließen, bietet Flash Player automatische Stausänderungen (eine Funktionalität, die in früheren ActionScript-Versionen für Movieclips bereitgestellt wurde, die als Schaltflächen verwendet werden). Diese automatischen Statusänderungen sind für Sprites nicht verfügbar, da diese keine Zeitleiste und somit auch keine Bildbezeichnungen besitzen.

Container verwenden einen internen Inhaltsbereich zum Steuern des Bildlaufs. Der Wert für creatingContentPane ist true, während der Container den Inhaltsbereich erstellt, sodass manche Ereignisse ignoriert oder blockiert werden können.

Das Button-Steuerelement, das als Standardschaltfläche für den Container bestimmt ist. Wenn Steuerelementen im Container der Fokus zugewiesen ist, entspricht das Drücken der Eingabetaste dem Klicken auf das Button-Steuerelement.

Gibt an, ob dieses Objekt doubleClick-Ereignisse empfängt. Der Standardwert ist false. Das heißt, dass eine InteractiveObject-Instanz standardmäßig keine doubleClick-Ereignisse erhält. Ist die doubleClickEnabled-Eigenschaft auf true gesetzt, empfängt die Instanz doubleClick-Ereignisse innerhalb ihrer Grenzen. Die mouseEnabled-Eigenschaft der InteractiveObject-Instanz muss ebenfalls auf true gesetzt werden, damit das Objekt doubleClick-Ereignisse empfängt.

Durch das Festlegen dieser Eigenschaft wird kein Ereignis ausgelöst. Sie müssen die addEventListener()-Methode verwenden, um einen Ereignis-Listener für das doubleClick-Ereignis hinzuzufügen.

Gibt das Anzeigeobjekt an, über das der Sprite gezogen wird oder auf dem der Sprite abgelegt wurde.

Ruft den FocusManager ab, der den Fokus für diese und gleichrangige Komponenten steuert. Jedes Popup hat eine eigene Fokusschleife und ist daher eine eigene FocusManager-Instanz. Mit dieser Methode stellen Sie sicher, dass Sie mit der richtigen Instanz kommunizieren.

Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird. Es sind drei Werte möglich: true, false oder null. Die Werte true und false geben an, ob ein Fokusrechteck angezeigt wird oder nicht. Der Wert null gibt an, dass dieses Objekt der stageFocusRect-Eigenschaft der Bühne unterliegt.

Legt das Graphics-Objekt fest, das zu diesem Sprite gehört und für das Vektorzeichnungsbefehle zulässig sind.

Gibt als Kollisionsbereich für ein Sprite ein anderes Sprite an. Wenn die hitArea-Eigenschaft nicht vorhanden ist oder den Wert null oder undefined aufweist, wird das Sprite selbst als Kollisionsbereich verwendet. Der Wert der hitArea-Eigenschaft kann ein Verweis auf ein Sprite-Objekt sein.

Die hitArea-Eigenschaft kann jederzeit geändert werden. Das geänderte Sprite übernimmt sofort das neue Verhalten des Kollisionsbereichs. Das als Kollisionsbereich bestimmte Sprite braucht nicht sichtbar zu sein. Auch wenn es unsichtbar ist, wird seine grafische Form dennoch als Kollisionsbereich erkannt.

Hinweis: Sie müssen die mouseEnabled-Eigenschaft des als Kollisionsbereich vorgesehenen Sprites auf false setzen. Sonst kann es vorkommen, dass Ihre Sprite-Schaltfläche nicht funktioniert, da nicht Ihre Sprite-Schaltfläche, sondern das als Kollisionsbereich bestimmte Sprite die Benutzereingabeereignisse empfängt.

Die aktuelle Position der horizontalen Bildlaufleiste. Diese entspricht dem Abstand zwischen dem linken Rand der bildlauffähigen Oberfläche und dem Element, das sich am weitesten links auf der derzeit sichtbaren Fläche befindet.

Bestimmt, ob die untergeordneten Elemente des Objekts maus- oder benutzereingabegerätfähig sind oder nicht. Wenn ein Objekt aktiviert ist, kann ein Benutzer damit interagieren, indem er eine Maus oder ein anderes Benutzereingabegerät verwendet. Der Standardwert lautet true.

Diese Eigenschaft ist praktisch, wenn Sie eine Schaltfläche mit einer Instanz der Sprite-Klasse (anstelle der SimpleButton-Klasse) erstellen. Wenn Sie zum Erstellen einer Schaltfläche eine Sprite-Instanz verwenden, können Sie die Schaltfläche ausrüsten und mithilfe der addChild()-Methode zusätzliche Sprite-Instanzen hinzufügen. Dieser Vorgang kann zu unerwarteten Verhaltensweisen bei Mausereignissen führen, da die untergeordneten Sprite-Instanzen zum Zielobjekt eines Mausereignisses werden können, wenn eigentlich die übergeordnete Instanz des Zielobjekts erwartet wird. Um sicherzustellen, dass die übergeordnete Instanz als Zielobjekt für Mausereignisse dient, können Sie die mouseChildren-Eigenschaft der übergeordneten Instanz auf false setzen.

Durch das Festlegen dieser Eigenschaft wird kein Ereignis ausgelöst. Um interaktive Funktionalität zu erzielen, müssen Sie die addEventListener()-Methode verwenden.

Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt. Der Standardwert ist true, d. h., dass standardmäßig jede InteractiveObject-Instanz, die sich in der Anzeigeliste befindet, Mausereignisse oder andere Benutzereingabeereignisse erhält. Wenn mouseEnabled auf false eingestellt ist, empfängt die Instanz keine Mausereignisse (oder andere Benutzereingabeereignisse wie Tastaturereignisse). Untergeordnete Elemente dieser Instanz in der Anzeigeliste sind nicht betroffen. Wenn Sie das mouseEnabled-Verhalten für alle Objekte ändern möchten, die einem Objekt in der Anzeigeliste untergeordnet sind, verwenden Sie flash.display.DisplayObjectContainer.mouseChildren.

Durch das Festlegen dieser Eigenschaft wird kein Ereignis ausgelöst. Um interaktive Funktionalität zu erzielen, müssen Sie die addEventListener()-Methode verwenden.

Liefert die Anzahl der Objekte, die diesem Objekt untergeordnet sind.

Steuert den Sound innerhalb dieses Sprites.

Hinweis: Diese Eigenschaft betrifft nicht HTML-Inhalt in einem HTMLControl-Objekt (in Adobe AIR).

Bestimmt, ob die dem Objekt untergeordneten Objekte per Tabulatortaste aktivierbar sind.

Hinweis:Verwenden Sie diese Eigenschaft nicht in Flex. Verwenden Sie stattdessen die UIComponent.hasFocusableChildren-Eigenschaft.

Verwandte API-Elemente

Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet. Liegt dieses Objekt in der Tabulatorreihenfolge vor, ist der Wert true, andernfalls false. Der Standardwert ist false, mit folgender Ausnahme:

• Bei einem SimpleButton-Objekt lautet der Wert true.
• Bei einem TextField-Objekt mit type = "input" lautet der Wert true.
• Bei einem Sprite-Objekt oder MovieClip-Objekt mit buttonMode = true lautet der Wert true.

Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an. Die Eigenschaft tabIndex hat standardmäßig den Wert -1, d. h., für das Objekt ist kein Tabulatorindex gesetzt.

Wenn eines der gegenwärtig in der SWF-Datei angezeigten Objekte die tabIndex-Eigenschaft aufweist, wird die automatische Tabulatorreihenfolge deaktiviert und die Tabulatorreihenfolge anhand der tabIndex-Eigenschaften der Objekte in der SWF-Datei ermittelt. Bei der benutzerdefinierten Tabulatorreihenfolge werden nur Objekte berücksichtigt, die über die tabIndex-Eigenschaft verfügen.

Die tabIndex-Eigenschaft kann eine positive Ganzzahl sein. Die Objekte werden entsprechend den tabIndex-Eigenschaften in aufsteigender Reihenfolge angeordnet. Dabei liegt ein Objekt mit einem tabIndex-Wert von 1 in der Reihenfolge vor einem Objekt mit einem tabIndex-Wert von 2. Derselbe tabIndex-Wert darf nicht für mehrere Objekte verwendet werden.

Die durch die tabIndex-Eigenschaft festgelegte benutzerdefinierte Tabulatorreihenfolge ist flat. Das heißt, die hierarchischen Beziehungen zwischen Objekten in der SWF-Datei bleiben unberücksichtigt. Alle Objekte in der SWF-Datei, die die tabIndex-Eigenschaften aufweisen, werden in die Tabulatorreihenfolge eingeordnet, die wiederum durch die Reihenfolge der tabIndex-Werte bestimmt wird.

Hinweis: Um die Tabulatorreihenfolge für TLFTextField-Instanzen festzulegen, wandeln Sie das untergeordnete Anzeigeobjekt von TLFTextField in ein InteractiveObject um und legen Sie dann die tabIndex-Eigenschaft fest. Beispiel:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Liefert ein TextSnapshot-Objekt für diese DisplayObjectContainer-Instanz.

Ein boolescher Wert, der angibt, ob der Handcursor angezeigt werden soll, wenn der Zeiger über ein Sprite geführt wird, in dem die buttonMode-Eigenschaft auf true gesetzt ist. Der Standardwert für die useHandCursor-Eigenschaft lautet true. Wenn useHandCursor auf true gesetzt ist, erscheint der für Schaltflächen verwendete Handcursor, wenn Benutzer den Zeiger auf ein Schaltflächen-Sprite bewegen. Wenn useHandCursor auf false gesetzt ist, wird stattdessen der Pfeilcursor verwendet.

Die useHandCursor-Eigenschaft kann jederzeit geändert werden. Das geändert Sprite übernimmt sofort das neue Cursorverhalten.

Hinweis: Wenn das Sprite in Flex oder Flash Builder untergeordnete Sprites enthält, empfiehlt es sich möglicherweise, die mouseChildren-Eigenschaft auf false zu setzen. Wenn beispielsweise ein Handcursor über einer Flex-Steuerung <mx:Label> eingeblendet werden soll, stellen Sie die Eigenschaften useHandCursor und buttonMode auf true und die Eigenschaft mouseChildren auf false ein.

Die aktuelle Position der vertikalen Bildlaufleiste. Diese entspricht dem Abstand zwischen dem oberen Rand der bildlauffähigen Oberfläche und dem Element, das sich am weitesten oben auf der derzeit sichtbaren Fläche befindet.

Gibt ein Objekt zurück, das über vier Eigenschaften verfügt: left, top, right und bottom. Der Wert jeder Eigenschaft ist gleich der Stärke des Chroms (visuelle Elemente) um den Rand des Containers herum.

Dieses Chrom enthält die Rahmenstärke. Wenn der Eigenschaftswert der horizontalScrollPolicy oder verticalScrollPolicy auf ScrollPolicy.ON eingestellt ist, enthält das Chrom auch die Stärke der entsprechenden Bildlaufleiste. Ist eine Bildlaufrichtlinie auf ScrollPolicy.AUTO eingestellt, umfassen die Abmessungen des Chroms nicht die Stärke der Bildlaufleiste, und zwar auch dann nicht, wenn die Bildlaufleiste angezeigt wird.

Unterklassen von Container sollten diese Methode überschreiben, sodass sie andere, bei der Platzierung der untergeordneten Elemente des Containers zu berücksichtigende Chroms umfassen. Beispiel: Die viewMetrics-Eigenschaft für die Panel-Klasse sollte ein Objekt zurückgeben, dessen top-Eigenschaft die Stärke der Titelleiste des Panel-Containers enthält.

Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. Die untergeordnete Instanz wird allen anderen untergeordneten Objekten dieser DisplayObjectContainer-Instanz an der ersten Position (also oben) hinzugefügt. (Um ein untergeordnetes Objekt an einer bestimmten Indexposition hinzuzufügen, verwenden Sie die addChildAt()-Methode.)

Wenn Sie ein Child-Objekt hinzufügen, das bereits einem anderen Anzeigeobjektcontainer untergeordnet worden ist, wird es aus dessen Child-Liste entfernt.

Hinweis: Der Befehl stage.addChild() kann mit einer veröffentlichten SWF-Datei Probleme verursachen, darunter Sicherheitsprobleme und Konflikte mit anderen geladenen SWF-Dateien. In einer Flash-Laufzeitinstanz gibt es immer nur eine Bühne, unabhängig davon, wie viele SWF-Dateien Sie in die Laufzeitumgebung laden. Im Allgemeinen sollten Objekte deshalb gar nicht direkt zur Bühne hinzugefügt werden. Das einzige Objekt, dass die Bühne enthalten sollte, ist das Stammobjekt. Erstellen Sie einen DisplayObjectContainer, um alle Elemente der Anzeigeliste aufzunehmen. Falls erforderlich, fügen Sie diese DisplayObjectContainer-Instanz dann der Bühne hinzu.

Parameter

Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. Das untergeordnete Objekt wird an der angegebenen Indexposition eingefügt. Die Indexposition 0 bezeichnet das hintere (untere) Ende der Anzeigeliste für dieses DisplayObjectContainer-Objekt.

Das folgende Beispiel enthält z. B. drei Anzeigeobjekte mit der Bezeichnung a, b und c jeweils an den Indexpositionen 0, 1 und 2:

Wenn Sie ein Child-Objekt hinzufügen, das bereits einem anderen Anzeigeobjektcontainer untergeordnet worden ist, wird es aus dessen Child-Liste entfernt.

Parameter

Gibt an, ob aufgrund der Sicherheitseinschränkungen irgendwelche Anzeigeobjekte aus der Liste ausgeschlossen werden, die beim Aufrufen der DisplayObjectContainer.getObjectsUnderPoint()-Methode mit dem angegebenen point-Punkt zurückgegeben wird. Standardmäßig können Inhalte aus der Domäne nicht auf Objekte aus einer anderen Domäne zugreifen, wenn ihnen dies nicht durch den Aufruf der Security.allowDomain()-Methode ausdrücklich erlaubt worden ist. Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.

Der Parameter point befindet sich im Koordinatenraum der Bühne, der vom Koordinatenraum des Anzeigeobjekt-Containers abweichen kann (wenn der Anzeigeobjekt-Container nicht gerade die Bühne selbst ist). Mithilfe der Methoden globalToLocal() und localToGlobal() können Sie Punkte zwischen diesen Koordinatenräumen konvertieren.

Parameter

Ermittelt, ob das angegebene Anzeigeobjekt der DisplayObjectContainer-Instanz oder der Instanz selbst untergeordnet ist. Die Suche umfasst die gesamte Anzeigeliste einschließlich dieser DisplayObjectContainer-Instanz. Für Objekte, die über mehrere Ebenen hinweg untergeordnet sind, wird der Wert true zurückgegeben.

Parameter

Gibt die untergeordnete Anzeigeobjektinstanz zurück, die sich an der angegebenen Indexposition befindet.

Parameter

Gibt das untergeordnete Anzeigeobjekt für den angegebenen Namen zurück. Wenn mehrere untergeordnete Anzeigeobjekte den angegebenen Namen aufweisen, gibt die Methode das erste Objekt in der Child-Liste zurück.

Die getChildAt()-Methode ist schneller als die getChildByName()-Methode. Die getChildAt()-Methode greift über ein zwischengespeichertes Array auf ein untergeordnetes Objekt zu, während die getChildByName()-Methode eine verknüpfte Liste durchlaufen muss, um auf ein untergeordnetes Objekt zuzugreifen.

Parameter

Gibt die Indexposition einer child-DisplayObject-Instanz zurück.

Parameter

Gibt ein Array an Objekten zurück, die unter dem angegebenen Punkt liegen und dieser DisplayObjectContainer-Instanz untergeordnet sind (auch über mehrere Unterordnungsstufen hinweg). Untergeordnete Objekte, die aus Sicherheitsgründen nicht zugänglich sind, sind in dem zurückgegebenen Array ausgelassen. Um festzustellen, ob sich diese Sicherheitseinschränkung auf das zurückgegebene Array auswirkt, rufen Sie die areInaccessibleObjectsUnderPoint()-Methode auf.

Der Parameter point befindet sich im Koordinatenraum der Bühne, der vom Koordinatenraum des Anzeigeobjekt-Containers abweichen kann (wenn der Anzeigeobjekt-Container nicht gerade die Bühne selbst ist). Mithilfe der Methoden globalToLocal() und localToGlobal() können Sie Punkte zwischen diesen Koordinatenräumen konvertieren.

Parameter

Entfernt die angegebene child-DisplayObject-Instanz aus der Child-Liste der DisplayObjectContainer-Instanz. Die parent-Eigenschaft des entfernten untergeordneten Objekts wird auf null gesetzt, und das Objekt wird vom Garbage Collector entfernt, wenn keine anderen Verweise auf das untergeordnete Objekt existieren. Die Indexpositionen von Anzeigeobjekten über dem untergeordneten Objekt im Anzeigeobjekt-Container werden um jeweils 1 herabgesetzt.

Der Garbage Collector weist nicht verwendete Speicherkapazität neu zu. Wenn auf Variablen oder Objekte nicht mehr aktiv verwiesen wird und diese auch nirgends mehr gespeichert sind, werden sie vom Garbagekollektor entfernt, und der belegte Arbeitsspeicher wird bereinigt.

Parameter

Entfernt ein untergeordnetes Anzeigeobjekt aus der angegebenen index-Position in der Child-Liste des Anzeigeobjekt-Containers. Die parent-Eigenschaft des entfernten untergeordneten Objekts wird auf null gesetzt, und das Objekt wird vom Garbage Collector entfernt, wenn keine anderen Verweise auf das untergeordnete Objekt existieren. Die Indexpositionen von Anzeigeobjekten über dem untergeordneten Objekt im Anzeigeobjekt-Container werden um jeweils 1 herabgesetzt.

Der Garbage Collector weist nicht verwendete Speicherkapazität neu zu. Wenn auf Variablen oder Objekte nicht mehr aktiv verwiesen wird und diese auch nirgends mehr gespeichert sind, werden sie vom Garbagekollektor entfernt, und der belegte Arbeitsspeicher wird bereinigt.

Parameter

Ändert die Position eines vorhandenen untergeordneten Objekts im Anzeigeobjekt-Container. Dies wirkt sich auf die Anordnung der untergeordneten Objekte aus. Das folgende Beispiel enthält z. B. drei Anzeigeobjekte mit der Bezeichnung a, b und c jeweils an den Indexpositionen 0, 1 und 2:

Wenn Sie die setChildIndex()-Methode verwenden und eine bereits belegte Indexposition angeben, werden nur die Positionen zwischen der alten und der neuen Position des Anzeigeobjekts geändert. Alle anderen Positionen bleiben unverändert. Wenn ein untergeordnetes Objekt an eine NIEDRIGERE Indexposition als bisher verschoben wird, werden alle dazwischen liegenden untergeordneten Objekte für den Indexverweis um 1 ERHÖHT. Wenn ein untergeordnetes Objekt an eine HÖHERE Indexposition als bisher verschoben wird, werden alle dazwischen liegenden untergeordneten Objekte für den Indexverweis um 1 VERRINGERT. Wenn der Anzeigeobjekt-Container im vorigen Beispiel z. B. den Namen container hat, können Sie die Position der Anzeigeobjekte mit den Bezeichnungen a und b austauschen, indem Sie den folgenden Code aufrufen:

container.setChildIndex(container.getChildAt(1), 0);

Dieser Code führt zur folgenden Objektanordnung:

Parameter

Ermöglicht es Benutzern, das angegebene Sprite mit einer Ziehoperation zu verschieben. Das Sprite bleibt so lange ziehbar, bis die Freigabe durch einen Aufruf der Sprite.stopDrag()-Methode aufgehoben wird oder bis ein anderes Sprite als ziehbares Objekt definiert wird. Es kann jeweils nur ein Sprite ziehbar sein.

Dreidimensionale Anzeigeobjekte folgen dem Zeiger und Sprite.startDrag() bewegt das Objekt innerhalb des dreidimensionalen Raums, der durch das Anzeigeobjekt festgelegt ist. Oder, wenn es sich bei dem Anzeigeobjekt um ein zweidimensionales Objekt handelt, das einem dreidimensionalen Objekt untergeordnet ist, bewegt sich das zweidimensionale Objekt innerhalb des dreidimensionalen Raums, der durch das übergeordnete dreidimensionale Objekt festgelegt ist.

Parameter

Beendet die startDrag()-Methode. Ein Sprite, das mit der startDrag()-Methode ziehbar gemacht wurde, bleibt so lange ziehbar, bis die stopDrag()-Methode hinzugefügt oder ein anderes Sprite ziehbar gemacht wird. Es kann jeweils nur ein Sprite ziehbar sein.

Kehrt die z-Reihenfolge (von vorne nach hinten) der beiden angegebenen untergeordneten Objekte um. Alle anderen untergeordneten Objekte im Anzeigeobjekt-Container bleiben auf derselben Indexposition.

Parameter

Kehrt die z-Reihenfolge (von vorne nach hinten) der untergeordneten Objekte an den beiden angegebenen Indexpositionen in der Child-Liste um. Alle anderen untergeordneten Objekte im Anzeigeobjekt-Container bleiben auf derselben Indexposition.

Parameter