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...
adobe.utils 

CustomActions  - AS3 Flash

Paketadobe.utils
Klassepublic final class CustomActions
VererbungCustomActions Inheritance Object

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: AIR 1.0, Flash Player 9

Die Methoden der CustomActions-Klasse ermöglichen einer im Flash-Authoring-Tool abgespielten SWF-Datei die Verwaltung von benutzerdefinierten Aktionen, die beim Authoring-Tool registriert sind. Eine SWF-Datei kann benutzerdefinierte Aktionen installieren und deinstallieren sowie die XML-Definition einer benutzerdefinierten Aktion und die Liste aller registrierten benutzerdefinierten Aktionen abrufen.

Mit diesen Methoden können Sie SWF-Dateien erstellen, die Erweiterungen des Flash-Authoring-Tools sind. Eine solche Erweiterung kann beispielsweise über das Flash Application Protocol in einem UDDI-Repository (Universal Description, Discovery and Integration) navigieren und Webdienste in die Werkzeugleiste „Aktionen“ herunterladen.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
  actionsList : Array
[statisch] [schreibgeschützt] Gibt ein Array-Objekt mit den Namen aller benutzerdefinierten Aktionen zurück, die beim Flash-Authoring-Tool registriert sind.
CustomActions
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
[statisch] Liest den Inhalt der XML-Definitionsdatei für benutzerdefinierte Aktionen mit dem Namen „name“.
CustomActions
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
  
[statisch] Installiert eine neue XML-Definitionsdatei für benutzerdefinierte Aktionen, die durch den Parameter „name“ angegeben ist.
CustomActions
 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
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
  
[statisch] Entfernt die XML-Definitionsdatei für benutzerdefinierte Aktionen mit dem Namen „name“.
CustomActions
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Eigenschaftendetails

actionsList

Eigenschaft
actionsList:Array  [schreibgeschützt]

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: AIR 1.0, Flash Player 9

Gibt ein Array-Objekt mit den Namen aller benutzerdefinierten Aktionen zurück, die beim Flash-Authoring-Tool registriert sind. Die Array-Elemente weisen einfache Dateinamen ohne die Erweiterung „xml“ und ohne Verzeichnistrennzeichen (z. B. „:“, „/“ oder „\“) auf. Wenn keine benutzerdefinierten Aktionen registriert sind, gibt actionsList() ein Array mit der Länge Null zurück Wenn ein Fehler auftritt, gibt actionsList() den Wert undefined zurück.



Implementierung
    public static function get actionsList():Array
Methodendetails

getActions

()Methode
public static function getActions(name:String):String

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: AIR 1.0, Flash Player 9

Liest den Inhalt der XML-Definitionsdatei für benutzerdefinierte Aktionen mit dem Namen name.

Die Definitionsdatei muss einen einfachen Dateinamen ohne die Erweiterung „xml“ und ohne Verzeichnistrennzeichen (':', '/' oder '\') aufweisen.

Wenn die durch name angegebene Definitionsdatei nicht gefunden werden kann, wird der Wert undefined zurückgegeben. Wenn die durch den Parameter name angegebene XML-Definition für benutzerdefinierte Aktionen gefunden wird, wird ihr gesamter Inhalt gelesen und als String zurückgegeben.

Parameter

name:String — Der Name der Definition für die benutzerdefinierte Aktion, die abgerufen werden soll.

Rückgabewerte
String — Wenn die XML-Definition für benutzerdefinierte Aktionen ermittelt wird, wird ein String zurückgegeben, andernfalls wird undefined zurückgegeben.

installActions

()Methode 
public static function installActions(name:String, data:String):void

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: AIR 1.0, Flash Player 9

Installiert eine neue XML-Definitionsdatei für benutzerdefinierte Aktionen, die durch den Parameter name angegeben ist. Der Inhalt der Datei wird durch den String data angegeben.

Die Definitionsdatei muss einen einfachen Dateinamen ohne die Erweiterung „xml“ und ohne Verzeichnistrennzeichen (':', '/' oder '\') aufweisen.

Wenn es bereits eine Datei für benutzerdefinierte Aktionen mit dem Namen name gibt, wird sie überschrieben.

Wenn das Verzeichnis „Configuration/ActionsPanel/CustomActions“ beim Aufruf dieser Methode noch nicht vorhanden ist, wird es erstellt.

Parameter

name:String — Der Name der Definition für die benutzerdefinierte Aktion, die installiert werden soll.
 
data:String — Der Text der zu installierenden XML-Definition.

uninstallActions

()Methode 
public static function uninstallActions(name:String):void

Sprachversion: ActionScript 3.0
Produktversion: Flash CS3
Laufzeitversionen: AIR 1.0, Flash Player 9

Entfernt die XML-Definitionsdatei für benutzerdefinierte Aktionen mit dem Namen name.

Die Definitionsdatei muss einen einfachen Dateinamen ohne die Erweiterung „xml“ und ohne Verzeichnistrennzeichen (':', '/' oder '\') aufweisen.

Parameter

name:String — Der Name der Definition für die benutzerdefinierte Aktion, die deinstalliert werden soll.

Verwandte API-Elemente





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