| Paket | mx.core |
| Schnittstelle | public interface IContainer extends IUIComponent , IFlexDisplayObject , IBitmapDrawable , IEventDispatcher |
| Umsetzer | Container, Legend |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts. | IFlexDisplayObject | |
| alpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an. | IFlexDisplayObject | |
| baselinePosition : Number [schreibgeschützt]
Die y-Koordinate der Grundlinie der ersten Textzeile der Komponente. | IUIComponent | |
| blendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll. | IFlexDisplayObject | |
| buttonMode : Boolean
Legt den Schaltflächenmodus für dieses Sprite fest. | IContainer | ||
| cacheAsBitmap : Boolean
Wird diese Eigenschaft auf „true“ gesetzt, speichern Flash-Laufzeitumgebungen eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache. | IFlexDisplayObject | |
| creatingContentPane : Boolean
Container verwenden einen internen Inhaltsbereich zum Steuern des Bildlaufs. | IContainer | ||
| defaultButton : IFlexDisplayObject
Das Button-Steuerelement, das als Standardschaltfläche für den Container bestimmt ist. | IContainer | ||
| document : Object
Ein Verweis auf das Dokumentobjekt, das mit dieser Komponente verknüpft ist. | IUIComponent | |
| doubleClickEnabled : Boolean
Gibt an, ob das Objekt doubleClick-Ereignisse empfängt. | IContainer | ||
| dropTarget : DisplayObject [schreibgeschützt]
Gibt das Anzeigeobjekt an, über das der Sprite gezogen wird oder auf dem der Sprite abgelegt wurde. | IContainer | ||
| enabled : Boolean
Legt fest, ob die Komponente Benutzereingaben akzeptieren kann. | IUIComponent | |
| explicitHeight : Number
Die explizit festgelegte Höhe für die Komponente in Pixeln als Koordinaten der Komponente. | IUIComponent | |
| explicitMaxHeight : Number [schreibgeschützt]
Eine Zahl, die die maximale Höhe der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| explicitMaxWidth : Number [schreibgeschützt]
Eine Zahl, die die maximale Breite der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| explicitMinHeight : Number [schreibgeschützt]
Eine Zahl, die die minimale Höhe der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| explicitMinWidth : Number [schreibgeschützt]
Eine Zahl, die die minimale Breite der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| explicitWidth : Number
Die explizit festgelegte Breite für die Komponente in Pixeln als Koordinaten der Komponente. | IUIComponent | |
| filters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält. | IFlexDisplayObject | |
| focusManager : IFocusManager [schreibgeschützt]
Ruft den FocusManager ab, der den Fokus für diese und gleichrangige Komponenten steuert. | IContainer | ||
| focusPane : Sprite
Ein einzelnes Sprite-Objekt, das von Komponenten gemeinsam und als Überlagerung für das Zeichnen der Fokusanzeige verwendet wird. | IUIComponent | |
| focusRect : Object
Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird. | IContainer | ||
| graphics : Graphics [schreibgeschützt]
Legt das Graphics-Objekt fest, das zu diesem Sprite gehört und für das Vektorzeichnungsbefehle zulässig sind. | IContainer | ||
| height : Number
Gibt die Höhe des Anzeigeobjekts in Pixeln an. | IFlexDisplayObject | |
| hitArea : Sprite
Gibt als Kollisionsbereich für ein Sprite ein anderes Sprite an. | IContainer | ||
| horizontalScrollPosition : Number
Die aktuelle Position der horizontalen Bildlaufleiste. | IContainer | ||
| includeInLayout : Boolean
Gibt an, ob diese Komponente im Layout des übergeordneten Containers enthalten ist. | IUIComponent | |
| isPopUp : Boolean
Wird vom PopUpManager auf „true“ gesetzt, um anzugeben, dass für die Komponente ein Popup eingeblendet wird. | IUIComponent | |
| loaderInfo : LoaderInfo [schreibgeschützt]
Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört. | IFlexDisplayObject | |
| mask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert. | IFlexDisplayObject | |
| maxHeight : Number [schreibgeschützt]
Eine Zahl, die die maximale Höhe der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| maxWidth : Number [schreibgeschützt]
Eine Zahl, die die maximale Breite der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| measuredHeight : Number [schreibgeschützt]
Die gemessene Höhe dieses Objekts. | IFlexDisplayObject | |
| measuredMinHeight : Number
Die standardmäßige Mindesthöhe der Komponente in Pixeln. | IUIComponent | |
| measuredMinWidth : Number
Die standardmäßige Mindestbreite der Komponente in Pixeln. | IUIComponent | |
| measuredWidth : Number [schreibgeschützt]
Die gemessene Breite dieses Objekts. | IFlexDisplayObject | |
| minHeight : Number [schreibgeschützt]
Eine Zahl, die die minimale Höhe der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| minWidth : Number [schreibgeschützt]
Eine Zahl, die die minimale Breite der Komponente in Pixeln als Koordinaten der Komponente angibt. | IUIComponent | |
| mouseChildren : Boolean
Bestimmt, ob die untergeordneten Elemente des Objekts maus- oder benutzereingabegerätfähig sind oder nicht. | IContainer | ||
| mouseEnabled : Boolean
Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt. | IContainer | ||
| mouseX : Number [schreibgeschützt]
Gibt die x-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | IFlexDisplayObject | |
| mouseY : Number [schreibgeschützt]
Gibt die y-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | IFlexDisplayObject | |
| name : String
Gibt den Instanznamen des Anzeigeobjekts an. | IFlexDisplayObject | |
| numChildren : int [schreibgeschützt]
Liefert die Anzahl der Objekte, die diesem Objekt untergeordnet sind. | IContainer | ||
| opaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist. | IFlexDisplayObject | |
| owner : DisplayObjectContainer
Der Eigentümer dieses IVisualElement-Objekts. | IUIComponent | |
| parent : DisplayObjectContainer [schreibgeschützt]
Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält. | IFlexDisplayObject | |
| percentHeight : Number
Eine Zahl, die die Höhe einer Komponente als Prozentsatz der Größe ihres übergeordneten Objekts festlegt. | IUIComponent | |
| percentWidth : Number
Eine Zahl, die die Breite einer Komponente als Prozentsatz der Größe ihres übergeordneten Objekts festlegt. | IUIComponent | |
| root : DisplayObject [schreibgeschützt]
Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert. | IFlexDisplayObject | |
| rotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an. | IFlexDisplayObject | |
| scale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster. | IFlexDisplayObject | |
| scaleX : Number
Gibt die horizontale Skalierung (Prozentwert) des Objekts ausgehend vom Registrierungspunkt an. | IFlexDisplayObject | |
| scaleY : Number
Gibt die vertikale Skalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | IFlexDisplayObject | |
| scrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt. | IFlexDisplayObject | |
| soundTransform : flash.media:SoundTransform
Steuert den Sound innerhalb dieses Sprites. | IContainer | ||
| stage : Stage [schreibgeschützt]
Die Bühne des Anzeigeobjekts. | IFlexDisplayObject | |
| systemManager : ISystemManager
Ein Verweis auf das SystemManager-Objekt für diese Komponente. | IUIComponent | |
| tabChildren : Boolean
Bestimmt, ob die dem Objekt untergeordneten Objekte per Tabulatortaste aktivierbar sind. | IContainer | ||
| tabEnabled : Boolean
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet. | IContainer | ||
| tabIndex : int
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an. | IContainer | ||
| textSnapshot : flash.text:TextSnapshot [schreibgeschützt]
Liefert ein TextSnapshot-Objekt für diese DisplayObjectContainer-Instanz. | IContainer | ||
| transform : flash.geom:Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören. | IFlexDisplayObject | |
| tweeningProperties : Array
Vom EffectManager verwendet. | IUIComponent | |
| useHandCursor : Boolean
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. | IContainer | ||
| verticalScrollPosition : Number
Die aktuelle Position der vertikalen Bildlaufleiste. | IContainer | ||
| viewMetrics : EdgeMetrics [schreibgeschützt]
Gibt ein Objekt zurück, das über vier Eigenschaften verfügt: „left“, „top“, „right“ und „bottom“. | IContainer | ||
| visible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht. | IFlexDisplayObject | |
| width : Number
Gibt die Breite des Anzeigeobjekts in Pixeln an. | IFlexDisplayObject | |
| x : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | IFlexDisplayObject | |
| y : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | IFlexDisplayObject | |
| Methode | Definiert von | ||
|---|---|---|---|
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. | IContainer | ||
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. | IContainer | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | IEventDispatcher | |
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. | IContainer | ||
Ermittelt, ob das angegebene Anzeigeobjekt der DisplayObjectContainer-Instanz oder der Instanz selbst untergeordnet ist. | IContainer | ||
|
Sendet ein Ereignis in den Ereignisablauf. | IEventDispatcher | |
|
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert. | IFlexDisplayObject | |
Gibt die untergeordnete Anzeigeobjektinstanz zurück, die sich an der angegebenen Indexposition befindet. | IContainer | ||
Gibt das untergeordnete Anzeigeobjekt für den angegebenen Namen zurück. | IContainer | ||
Gibt die Indexposition einer untergeordneten DisplayObject-Instanz zurück. | IContainer | ||
|
Eine bequeme Methode, um anzugeben, ob die explizite oder gemessene Höhe verwendet werden soll
| IUIComponent | |
|
Eine bequeme Methode, um anzugeben, ob die explizite oder gemessene Breite verwendet werden soll
| IUIComponent | |
Gibt ein Array an Objekten zurück, die unter dem angegebenen Punkt liegen und dieser DisplayObjectContainer-Instanz untergeordnet sind (auch über mehrere Unterordnungsstufen hinweg). | IContainer | ||
|
Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter „targetCoordinateSpace“ definierten Koordinatensystems. | IFlexDisplayObject | |
|
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts. | IFlexDisplayObject | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | IEventDispatcher | |
|
Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet. | IFlexDisplayObject | |
|
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet. | IFlexDisplayObject | |
|
Initialisiert das Objekt. | IUIComponent | |
|
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten. | IFlexDisplayObject | |
|
Verschiebt dieses Objekt an die angegebenen x- und y-Koordinaten. | IFlexDisplayObject | |
|
Gibt „true“ zurück, wenn die Kette von „owner“-Eigenschaften von „child“ auf diese UIComponent verweist. | IUIComponent | |
|
Wird von Flex aufgerufen, wenn ein UIComponent-Objekt einem übergeordneten Element hinzugefügt oder daraus entfernt wird. | IUIComponent | |
Entfernt die angegebene untergeordnete DisplayObject-Instanz aus der Child-Liste der DisplayObjectContainer-Instanz. | IContainer | ||
Entfernt ein untergeordnetes Anzeigeobjekt aus der angegebenen Indexposition in der Child-Liste des Anzeigeobjekt-Containers. | IContainer | ||
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | IEventDispatcher | |
|
Legt die tatsächliche Größe dieses Objekts fest. | IFlexDisplayObject | |
Ändert die Position eines vorhandenen untergeordneten Objekts im Anzeigeobjekt-Container. | IContainer | ||
|
Wird aufgerufen, wenn sich die visible-Eigenschaft ändert. | IUIComponent | |
Ermöglicht es Benutzern, das angegebene Sprite mit einer Ziehoperation zu verschieben. | IContainer | ||
Beendet die startDrag()-Methode. | IContainer | ||
Kehrt die z-Reihenfolge (von vorne nach hinten) der beiden angegebenen untergeordneten Objekte um. | IContainer | ||
Kehrt die z-Reihenfolge (von vorne nach hinten) der untergeordneten Objekte an den beiden angegebenen Indexpositionen in der Child-Liste um. | IContainer | ||
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | IEventDispatcher | |
buttonMode | Eigenschaft |
buttonMode:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get buttonMode():Boolean public function set buttonMode(value:Boolean):voidcreatingContentPane | Eigenschaft |
creatingContentPane:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get creatingContentPane():Boolean public function set creatingContentPane(value:Boolean):voiddefaultButton | Eigenschaft |
defaultButton:IFlexDisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get defaultButton():IFlexDisplayObject public function set defaultButton(value:IFlexDisplayObject):voiddoubleClickEnabled | Eigenschaft |
doubleClickEnabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voiddropTarget | Eigenschaft |
dropTarget:DisplayObject [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt das Anzeigeobjekt an, über das der Sprite gezogen wird oder auf dem der Sprite abgelegt wurde.
Implementierung
public function get dropTarget():DisplayObjectfocusManager | Eigenschaft |
focusManager:IFocusManager [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get focusManager():IFocusManagerfocusRect | Eigenschaft |
focusRect:Object| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get focusRect():Object public function set focusRect(value:Object):voidgraphics | Eigenschaft |
hitArea | Eigenschaft |
hitArea:Sprite| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get hitArea():Sprite public function set hitArea(value:Sprite):voidhorizontalScrollPosition | Eigenschaft |
horizontalScrollPosition:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):voidmouseChildren | Eigenschaft |
mouseChildren:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get mouseChildren():Boolean public function set mouseChildren(value:Boolean):voidmouseEnabled | Eigenschaft |
mouseEnabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidnumChildren | Eigenschaft |
soundTransform | Eigenschaft |
soundTransform:flash.media:SoundTransform| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Steuert den Sound innerhalb dieses Sprites.
Hinweis: Diese Eigenschaft betrifft nicht HTML-Inhalt in einem HTMLControl-Objekt (in Adobe AIR).
Implementierung
public function get soundTransform():flash.media:SoundTransform public function set soundTransform(value:flash.media:SoundTransform):voidtabChildren | Eigenschaft |
tabChildren:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get tabChildren():Boolean public function set tabChildren(value:Boolean):voidVerwandte API-Elemente
tabEnabled | Eigenschaft |
tabEnabled:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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 Werttrue. - Bei einem Sprite-Objekt oder MovieClip-Objekt mit
buttonMode = truelautet der Werttrue.
Implementierung
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | Eigenschaft |
tabIndex:int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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;Um die Tabulatorreihenfolge von der Standardreihenfolge für drei Instanzen eines TLFTextField-Objekts (
tlfInstance1, tlfInstance2 und tlfInstance3) umzukehren, verwenden Sie Folgendes:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementierung
public function get tabIndex():int public function set tabIndex(value:int):voidtextSnapshot | Eigenschaft |
textSnapshot:flash.text:TextSnapshot [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Liefert ein TextSnapshot-Objekt für diese DisplayObjectContainer-Instanz.
Implementierung
public function get textSnapshot():flash.text:TextSnapshotuseHandCursor | Eigenschaft |
useHandCursor:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get useHandCursor():Boolean public function set useHandCursor(value:Boolean):voidverticalScrollPosition | Eigenschaft |
verticalScrollPosition:Number| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get verticalScrollPosition():Number public function set verticalScrollPosition(value:Number):voidviewMetrics | Eigenschaft |
viewMetrics:EdgeMetrics [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
Implementierung
public function get viewMetrics():EdgeMetricsaddChild | () | Methode |
public function addChild(child:DisplayObject):DisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
child:DisplayObject — Die DisplayObject-Instanz, die der DisplayObjectContainer-Instanz untergeordnet werden soll.
|
DisplayObject — Die DisplayObject-Instanz, die Sie im Parameter child übergeben.
|
addChildAt | () | Methode |
public function addChildAt(child:DisplayObject, index:int):DisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
child:DisplayObject — Die DisplayObject-Instanz, die der DisplayObjectContainer-Instanz untergeordnet werden soll.
| |
index:int — Die Indexposition, an der die untergeordnete Instanz 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.
|
DisplayObject — Die DisplayObject-Instanz, die Sie im Parameter child übergeben.
|
areInaccessibleObjectsUnderPoint | () | Methode |
public function areInaccessibleObjectsUnderPoint(point:Point):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
point:Point — Der Punkt, unter dem nachgeschaut werden soll.
|
Boolean — true, wenn der Punkt untergeordnete Anzeigeobjekte mit Sicherheitseinschränkungen enthält.
|
contains | () | Methode |
public function contains(child:DisplayObject):Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
child:DisplayObject — Das zu prüfende untergeordnete Objekt.
|
Boolean — Ist auf true eingestellt, wenn das child-Objekt ein untergeordnetes Objekt der DisplayObjectContainer-Instanz oder des Containers selbst ist. Andernfalls ist false eingestellt.
|
getChildAt | () | Methode |
public function getChildAt(index:int):DisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die untergeordnete Anzeigeobjektinstanz zurück, die sich an der angegebenen Indexposition befindet.
Parameter
index:int — Die Indexposition des untergeordneten Objekts.
|
DisplayObject — Das untergeordnete Anzeigeobjekt an der angegebenen Indexposition.
|
getChildByName | () | Methode |
public function getChildByName(name:String):DisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
name:String — Der Name des untergeordneten Objekts, das zurückgegeben werden soll.
|
DisplayObject — Das untergeordnete Anzeigeobjekt für den angegebenen Namen.
|
getChildIndex | () | Methode |
public function getChildIndex(child:DisplayObject):int| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt die Indexposition einer child-DisplayObject-Instanz zurück.
Parameter
child:DisplayObject — Die DisplayObject-Instanz, die identifiziert werden soll.
|
int — Die Indexposition des untergeordneten Anzeigeobjekts, das identifiziert werden soll.
|
getObjectsUnderPoint | () | Methode |
public function getObjectsUnderPoint(point:Point):Array| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
point:Point — Der Punkt, unter dem nachgeschaut werden soll.
|
Array — Ein Array an Objekten, die unter dem angegebenen Punkt liegen und dieser DisplayObjectContainer-Instanz untergeordnet sind (auch über mehrere Unterordnungsstufen hinweg).
|
removeChild | () | Methode |
public function removeChild(child:DisplayObject):DisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
child:DisplayObject — Die zu entfernende DisplayObject-Instanz.
|
DisplayObject — Die DisplayObject-Instanz, die Sie im Parameter child übergeben.
|
removeChildAt | () | Methode |
public function removeChildAt(index:int):DisplayObject| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
index:int — Die Child-Indexposition des zu entfernenden Anzeigeobjekts.
|
DisplayObject — Die entfernte DisplayObject-Instanz.
|
setChildIndex | () | Methode |
public function setChildIndex(child:DisplayObject, index:int):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Ä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
child:DisplayObject — Die child-DisplayObject-Instanz, deren Indexnummer Sie ändern möchten.
| |
index:int — Die resultierende Indexnummer für das child-Anzeigeobjekt.
|
startDrag | () | Methode |
public function startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
lockCenter:Boolean (default = false)true) oder an der Stelle einrastet, an der der Benutzer zum ersten Mal auf das Sprite geklickt hat (false).
| |
bounds:Rectangle (default = null) |
stopDrag | () | Methode |
public function stopDrag():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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.
swapChildren | () | Methode |
public function swapChildren(child1:DisplayObject, child2:DisplayObject):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
child1:DisplayObject — Das erste untergeordnete Objekt.
| |
child2:DisplayObject — Das zweite untergeordnete Objekt.
|
swapChildrenAt | () | Methode |
public function swapChildrenAt(index1:int, index2:int):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
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
index1:int — Die Indexposition des ersten untergeordneten Objekts.
| |
index2:int — Die Indexposition des zweiten untergeordneten Objekts.
|
Tue Jun 12 2018, 10:04 AM Z