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

State  - AS3 Flex

Paketmx.states
Klassepublic class State
VererbungState Inheritance EventDispatcher Inheritance Object

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

Die State-Klasse definiert einen Ansichtsstatus, eine bestimmte Ansicht einer Komponente. Beispielsweise kann ein Produktpiktogramm zwei Ansichtsstatus besitzen: einen Basisansichtsstatus mit minimalen Informationen und einen Rich-Ansichtsstatus mit zusätzlichen Informationen. Die overrides-Eigenschaft gibt einen Satz Unterklassen an, die dem Basisansichtsstatus hinzugefügt oder daraus entfernt werden, sowie Eigenschaften, Stile und Ereignisprozeduren, die eingestellt werden, wenn der Ansichtsstatus angewendet wird.

Sie verwenden die State-Klasse in der states-Eigenschaft von Flex-Komponenten. Sie können nur eine states-Eigenschaft im Stamm einer Anwendung oder eines benutzerdefinierten Steuerelements angeben und nicht in untergeordneten Steuerelementen.

Sie aktivieren einen Ansichtsstatus durch Einstellen der currentState-Eigenschaft einer Komponente.

MXML-SyntaxexpandedMXML-Syntax ausblenden

The <mx:State> tag has the following attributes:

  <mx:State
  Properties
  basedOn="null"
  name="null"
  overrides="null"
  />
  

Standard-MXML-Eigenschaftoverrides

Verwandte API-Elemente



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  basedOn : String
Der Name des Ansichtsstatus, auf dem dieser Ansichtsstatus basiert, oder null, wenn dieser Ansichtsstatus auf keinem benannten Ansichtsstatus basiert.
State
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  name : String
Der Name des Ansichtsstatus.
State
  overrides : Array
Die Überschreibungen für diesen Ansichtsstatus als ein Array von Objekten, die die IOverride-Schnittstelle implementieren.
State
  stateGroups : Array
Array von Strings mit den Statusgruppen, zu denen dieser Ansichtsstatus gehört.
State
Öffentliche Methoden
 MethodeDefiniert von
  
State(properties:Object = null)
Konstruktor.
State
 Inherited
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.
EventDispatcher
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
  Wird ausgelöst, nachdem ein Ansichtsstatus eingegeben wurde.State
  Wird unmittelbar vor der Beendigung eines Ansichtsstatus ausgelöst.State
Eigenschaftendetails

basedOn

Eigenschaft
public var basedOn:String

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

Der Name des Ansichtsstatus, auf dem dieser Ansichtsstatus basiert, oder null, wenn dieser Ansichtsstatus auf keinem benannten Ansichtsstatus basiert. Wenn dieser Wert null entspricht, basiert der Ansichtsstatus auf einem Stammstatus, der aus den Eigenschaften, Stilen, Ereignisprozeduren und untergeordneten Elementen besteht, die Sie für eine Komponente ohne Verwendung einer State-Klasse definieren.

Der Standardwert ist null.

name

Eigenschaft 
public var name:String

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

Der Name des Ansichtsstatus. Anzeigestatusnamen müssen für eine gegebene Komponente eindeutig sein. Diese Eigenschaft muss eingestellt werden.

overrides

Eigenschaft 
public var overrides:Array

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

Die Überschreibungen für diesen Ansichtsstatus als ein Array von Objekten, die die IOverride-Schnittstelle implementieren. Diese Überschreibungen werden bei Eingabe des Status der Reihe nach angewendet und bei Deaktivierung des Status in umgekehrter Reihenfolge entfernt.

Die folgenden Flex-Klassen implementieren die IOverride-Schnittstelle und ermöglichen Ihnen die Definition der Merkmale des Ansichtsstatus:

  • AddChild
  • RemoveChild
  • SetEventHandler
  • SetProperty
  • SetStyle

Die overrides-Eigenschaft ist die Standardeigenschaft der State-Klasse. Sie können das <mx:overrides>-Tag und dessen untergeordnetes <mx:Array>-Tag auslassen, wenn Sie Überschreibungen mit dem MXML-Tag-Syntax definieren.

stateGroups

Eigenschaft 
public var stateGroups:Array

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

Array von Strings mit den Statusgruppen, zu denen dieser Ansichtsstatus gehört.

Konstruktordetails

State

()Konstruktor
public function State(properties:Object = null)

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

Konstruktor.

Parameter
properties:Object (default = null) — Objekt, das Eigenschaftseinstellungen für diesen Status enthält.
Ereignisdetails

enterState

Ereignis
Ereignisobjekttyp: mx.events.FlexEvent
Eigenschaft FlexEvent.type = mx.events.FlexEvent.ENTER_STATE

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

Wird ausgelöst, nachdem ein Ansichtsstatus eingegeben wurde.

Die FlexEvent.ENTER_STATE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein enterState-Ereignis.

Dieses Ereignis wird nur ausgelöst, wenn an das auslösende Objekt ein oder mehr entsprechende Listener angehängt sind.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

exitState

Ereignis  
Ereignisobjekttyp: mx.events.FlexEvent
Eigenschaft FlexEvent.type = mx.events.FlexEvent.EXIT_STATE

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

Wird unmittelbar vor der Beendigung eines Ansichtsstatus ausgelöst. Dieses Ereignis wird ausgelöst, bevor die Änderungen am Standardansichtsstatus entfernt werden.

Die FlexEvent.EXIT_STATE-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein exitState-Ereignis.

Dieses Ereignis wird nur ausgelöst, wenn an das auslösende Objekt ein oder mehr entsprechende Listener angehängt sind.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise myButton.addEventListener() zur Registrierung eines Ereignis-Listeners verwenden, weist currentTarget den Wert „myButton“ auf.
targetDas Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die currentTarget-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.




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