adobe.utilsXMLUI Die XMLUI-Klasse ermöglicht die Kommunikation mit SWF-Dateien, die als benutzerdefinierte Benutzeroberflächen für die Erweiterungsfunktionen des Flash-Authoring-Tools verwendet werden.XMLUI Object Die XMLUI-Klasse ermöglicht die Kommunikation mit SWF-Dateien, die als benutzerdefinierte Benutzeroberflächen für die Erweiterungsfunktionen des Flash-Authoring-Tools verwendet werden.

Macromedia Flash MX 2004 und Macromedia Flash MX Professional 2004 sowie höhere Versionen enthalten verschiedene Erweiterungsfunktionen einschließlich Verhalten, Befehle (JavaScript-API), Effekte und Werkzeuge. Mit diesen Funktionen können erfahrene Benutzer den Funktionsumfang des Authoring-Tools erweitern oder automatisieren. Die XML-in-UI-Engine kann mit diesen Erweiterungsfunktionen zum Erstellen von Dialogfeldern eingesetzt werden, die dem Benutzer angezeigt werden, wenn die Erweiterung Parameter erfordert oder akzeptiert. Dialogfelder können mit XML-Tags oder durch eine anzuzeigende SWF-Datei definiert werden. Das XMLUI-Objekt bietet einen Mechanismus, mit dem erfahrene Benutzer mit einer auf diese Weise verwendeten SWF-Datei kommunizieren können.

accept Schließt das aktuelle XMLUI-Dialogfeld mit dem Status „Akzeptieren“.XMLUI, XMLUI.accept(), accept() Schließt das aktuelle XMLUI-Dialogfeld mit dem Status „Akzeptieren“. Dies ist identisch mit dem Klicken des Benutzer auf die Schaltfläche „OK“. cancel Schließt das aktuelle XMLUI-Dialogfeld mit dem Status „Abbrechen“.XMLUI, XMLUI.cancel(), cancel() Schließt das aktuelle XMLUI-Dialogfeld mit dem Status „Abbrechen“. Dies ist identisch mit dem Klicken des Benutzer auf die Schaltfläche „Abbrechen“. getProperty Ruft den Wert der angegebenen Eigenschaft des aktuellen XMLUI-Dialogfelds ab.XMLUI, XMLUI.getProperty(), getProperty() Der Wert der Eigenschaft. StringnameStringDer Name der abzurufenden XMLUI-Eigenschaft. Ruft den Wert der angegebenen Eigenschaft des aktuellen XMLUI-Dialogfelds ab. setProperty Ändert den Wert der angegebenen Eigenschaft des aktuellen XMLUI-Dialogfelds.XMLUI, XMLUI.setProperty(), setProperty() nameStringDer Name der zu ändernden XMLUI-Eigenschaft. valueStringDer Wert, auf den die angegebene Eigenschaft eingestellt wird. Ändert den Wert der angegebenen Eigenschaft des aktuellen XMLUI-Dialogfelds. CustomActions 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.CustomActions object, CustomActions, built-in class Object 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.

getActions Liest den Inhalt der XML-Definitionsdatei für benutzerdefinierte Aktionen mit dem Namen „name“.CustomActions.getActions, CustomActions, getActions Wenn die XML-Definition für benutzerdefinierte Aktionen ermittelt wird, wird ein String zurückgegeben, andernfalls wird undefined zurückgegeben. StringnameStringDer Name der Definition für die benutzerdefinierte Aktion, die abgerufen werden soll. 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.

installActions Installiert eine neue XML-Definitionsdatei für benutzerdefinierte Aktionen, die durch den Parameter „name“ angegeben ist. Der boolesche Wert false, wenn während der Installation ein Fehler auftritt; andernfalls wird der boolesche Wert true zurückgegeben, um anzuzeigen, dass die benutzerdefinierte Aktion erfolgreich installiert wurde. nameStringDer Name der Definition für die benutzerdefinierte Aktion, die installiert werden soll. dataStringDer Text der zu installierenden XML-Definition. 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.

uninstallActions Entfernt die XML-Definitionsdatei für benutzerdefinierte Aktionen mit dem Namen „name“. CustomActions.uninstallActions, CustomActions, uninstallActions nameStringDer Name der Definition für die benutzerdefinierte Aktion, die deinstalliert werden soll. 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.

installActions()actionsList Gibt ein Array-Objekt mit den Namen aller benutzerdefinierten Aktionen zurück, die beim Flash-Authoring-Tool registriert sind.CustomActions.listActions, CustomActions, listActions Array 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. MMEndCommand Benachrichtigt eine Anwendung, die einen SWF-Befehl hostet, wenn ein Befehl ausgeführt wurde, und weist die Anwendung an, die vom MMExecute()-Befehl übermittelten Änderungen zu übernehmen oder zu verwerfen. endStatusBoolean Ein boolescher Wert; verwenden Sie true, um die Änderungen zu übernehmen, andernfalls false. Bei der Einstellung false werden alle ausstehenden Änderungen verworfen. notifyStringString Ein String mit einer Fehlermeldung oder dem Grund, weshalb die Änderungen verworfen werden. Wenn der endStatus-Parameter den Wert true hat, verwenden Sie einen leeren String als Wert für den notifyString-Parameter. Benachrichtigt eine Anwendung, die einen SWF-Befehl hostet, dass ein Befehl ausgeführt wurde, und weist die Anwendung an, die vom MMExecute()-Befehl übermittelten Änderungen zu übernehmen oder zu verwerfen. MMExecute Ermöglicht die Ausgabe von Flash JavaScript API (JSAPI)-Befehlen aus ActionScript.Ein String mit dem ggf. vom JavaScript-Statement gesendeten Resultat. StringnameString Ein an MMExecute() übergebener String. MMExecute() analysiert den String und führt ggf. alle JavaScript-Befehle aus. Sie können dem String eine Variable zuweisen und diese dann an MMExecute() übergeben. Sie können die JavaScript-Funktion auch in kleinere Strings aufteilen; MMExecute() gibt den Wert der zuletzt aufgerufenen Funktion zurück. Ermöglicht die Ausgabe von Flash JavaScript API (JSAPI)-Befehlen aus ActionScript. In Flash Professional kann die MMExecute-Funktion nur von einem Film aufgerufen werden, der als Flash-Bedienfeld, von einem XMLtoUI-Dialogfeld oder von der benutzerdefinierten UI einer Komponente verwendet wird. JSAPI-Befehle haben außerhalb der Authoring-Umgebung keinerlei Auswirkungen.

Die Flash-JSAPI bietet verschiedene Objekte, Methoden und Eigenschaften zum Duplizieren oder Emulieren von Befehlen, die ein Benutzer in der Authoring-Umgebung eingeben kann. Mithilfe der JSAPI können Sie Skripts schreiben, die Flash in verschiedener Hinsicht erweitern: Sie können Befehle zu Menüs hinzufügen, Objekte auf der Bühne verändern, Befehlssequenzen wiederholen usw.

Im Allgemeinen führt ein Benutzer ein JSAPI-Skript aus, indem er „Befehle“ > „Befehl ausführen“ wählt. Sie können diese Funktion in einem ActionScript jedoch auch dazu verwenden, um einen JSAPI-Befehl direkt aufzurufen. Wenn Sie in einem Skript in Bild 1 Ihrer Datei MMExecute() verwenden, wird der Befehl beim Laden der SWF-Datei ausgeführt.

Weitere Informationen zur JSAPI finden Sie in „Flash erweitern“ unter http://www.adobe.com/go/jsapi_info_en.