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

AutomationID  - AS3 Flex

Paketmx.automation
Klassepublic class AutomationID
VererbungAutomationID Inheritance Object

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

Das Flex-Automatisierungsframework verwendet die AutomationID-Klasse, um Objektidentifikationen zu erstellen, die von Agenten genutzt werden können. Die AutomationID besteht aus vielen AutomationIDParts, wobei jedes dieser Teile ein Objekt in der Hierarchie identifiziert. Die AutomationID definiert ein Serialisationsformat für ein Array von Matrizen. Mit dieser Klasse wird eine Hierarchie dargestellt, deren Segmente die Eigenschaften der einzelnen Objekte in der Hierarchie beschreiben. Das Serialisationsformat der ID ist:
property_1_name{property_1_value property_1_type}property_2_name{property_2_value property_2_type}|property_1_name{property_1_value property_1_type}property_2_name{property_2_value property_2_type}

Eine Flex-Anwendung hat beispielsweise folgende Hierarchie:

Application -- > Accordion -- > HBox -- > Button

Die AutomationID der Schaltfläche besteht aus vier AutomationIDParts: ein Teil für die Anwendung, ein Teil für Accordion, ein Teil für HBox und ein Teil für die Schaltfläche. Der AutomationIDPart ist eine Tabelle von Eigenschaftsnamen und deren Werten. Die Eigenschaftswertpaare sind je nach Objekttyp verschieden. Diese Eigenschaftswertpaare sollten eine eindeutige Identifizierung des Objekts ermöglichen.

AutomationID wird erzeugt, indem die übergeordnete Hierarchie des untergeordneten Leafobjekts abgeschritten wird und ein AutomationIDPart für jedes gefundene Objekt erzeugt wird. Übergeordnete Elemente, bei welchen showInAutomationHierarchy auf false gesetzt ist, werden übersprungen. Untergeordnete Elemente dieser übergeordneten Elemente werden als untergeordnete Elemente des nächst höheren übergeordneten Elements betrachtet, dessen showInAuto-Flag auf true gesetzt ist. Während der Aufzeichnung kann diese AutomationID vom Agenten gespeichert werden.

Wenn der Agent während der Wiedergabe die AutomationID zum Auffinden eines Objekts bereitstellt, wird die Display-Objekthierarchie vom obersten Anwendungsobjekt an abwärts abgeschritten. Auf jeder Ebene wird ein untergeordnetes Element, das dem AutomationIDPart am nächsten kommt, aus der Liste aller untergeordneten Elemente aufgenommen. Wenn mehrere untergeordnete Elemente den Kriterien entsprechen, wird ein Fehler ausgegeben. Die Benutzer sind dafür verantwortlich, solche Konflikte zu lösen, indem sie einen eindeutigen automationName vergeben oder Objekten neue Eigenschaften zuweisen, die sie eindeutig machen.

Agenten sollten diese Objektinformationen speichern, wenn sie Beständigkeit anstreben. AutomationID stellt toString() und parse()-Methoden bereit, um das Objekt in eine Stringdarstellung und zurück zu konvertieren.

Sie können die IAutomationManager.createAutomationID() und die IAutomationManager.resolveAutomationID()-Methode zum Erstellen bzw. Auflösen der AutomationID-Objekte verwenden.

Sie können die IAutomationObjectHelper.helpCreateIDPart() und IAutomationObjectHelper.helpResolveIDPart()-Methode verwenden, um ein untergeordnetes Element innerhalb des übergeordneten Elements zu identifizieren, welches mit dem AutomationIDPart übereinstimmt.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  length : int
[schreibgeschützt] Die Anzahl der Teile in dieser ID.
AutomationID
Öffentliche Methoden
 MethodeDefiniert von
  
Konstruktor.
AutomationID
  
Fügt einen Teil an den Anfang der ID an.
AutomationID
  
Fügt einen Teil an das Ende der ID an.
AutomationID
  
Verkettet eine weitere ID mit der aktuellen.
AutomationID
  
Vergleicht dieses Objekt mit der angegebenen AutomationID.
AutomationID
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
Gibt an, wenn diese ID mehrere Teile besitzt.
AutomationID
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
  
[statisch] Analysiert den String und gibt eine ID zurück.
AutomationID
  
Gibt das erste Objekt in der ID zurück.
AutomationID
  
Gibt das letzte Objekt in der ID zurück.
AutomationID
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Entfernt das erste Objekt aus dieser ID.
AutomationID
  
Entfernt das letzte Objekt aus dieser ID.
AutomationID
 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
  
Serialisiert diese ID zu einem String.
AutomationID
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

length

Eigenschaft
length:int  [schreibgeschützt]

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

Die Anzahl der Teile in dieser ID.



Implementierung
    public function get length():int
Konstruktordetails

AutomationID

()Konstruktor
public function AutomationID()

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

Konstruktor.

Methodendetails

addFirst

()Methode
public function addFirst(p:AutomationIDPart):void

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

Fügt einen Teil an den Anfang der ID an.

Parameter

p:AutomationIDPart — Eigenschaftenmatrix.

addLast

()Methode 
public function addLast(p:AutomationIDPart):void

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

Fügt einen Teil an das Ende der ID an.

Parameter

p:AutomationIDPart — Eigenschaftenmatrix.

concat

()Methode 
public function concat(other:AutomationID):AutomationID

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

Verkettet eine weitere ID mit der aktuellen. Gibt eine neue ID zurück und mutiert diese Instanz nicht.

Parameter

other:AutomationID — Die zu verkettende ID.

Rückgabewerte
AutomationID — Diese ID ist mit der anderen ID verkettet.

equals

()Methode 
public function equals(other:AutomationID):Boolean

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

Vergleicht dieses Objekt mit der angegebenen AutomationID.

Parameter

other:AutomationID — Zu vergleichendes AutomationID-Objekt.

Rückgabewerte
Booleantrue, wenn sie gleich sind und false, wenn nicht.

isEmpty

()Methode 
public function isEmpty():Boolean

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

Gibt an, wenn diese ID mehrere Teile besitzt.

Rückgabewerte
Booleantrue, wenn es keine weiteren Teile der ID gibt und false, wenn nicht.

parse

()Methode 
public static function parse(s:String):AutomationID

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

Analysiert den String und gibt eine ID zurück.

Parameter

s:String — Von der toString()-Methode bereitgestellte serialisierte Form der ID.

Rückgabewerte
AutomationID — Analysierte ID.

peekFirst

()Methode 
public function peekFirst():AutomationIDPart

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

Gibt das erste Objekt in der ID zurück.

Rückgabewerte
AutomationIDPart — Erstes Objekt in der ID.

peekLast

()Methode 
public function peekLast():AutomationIDPart

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

Gibt das letzte Objekt in der ID zurück.

Rückgabewerte
AutomationIDPart — Letztes Objekt in der ID.

removeFirst

()Methode 
public function removeFirst():AutomationIDPart

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

Entfernt das erste Objekt aus dieser ID.

Rückgabewerte
AutomationIDPart — Erstes Objekt in dieser ID.

removeLast

()Methode 
public function removeLast():AutomationIDPart

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

Entfernt das letzte Objekt aus dieser ID.

Rückgabewerte
AutomationIDPart — Letztes Objekt in dieser ID.

toString

()Methode 
public function toString():String

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

Serialisiert diese ID zu einem String.

Rückgabewerte
String — Die serialisierte ID.




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