Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Kopieren und Einfügen
Zurückgestellte Wiedergabe
Flash Player 10 und höher, Adobe AIR 1.0 und höher
Wenn die Erstellung eines Datenformats eine große Rechnerleistung erfordert, können Sie die zurückgestellte
Wiedergabe verwenden, indem Sie eine Funktion angeben, die die Daten bei Bedarf zur Verfügung stellt. Diese
Funktion wird nur dann aufgerufen, wenn der Empfänger eines Zieh- oder Einfügevorgangs die Daten im
zurückgestellten Format anfordert.
Die Wiedergabefunktion wird mit der Methode setDataHandler() zum Clipboard-Objekt hinzugefügt. Die
Funktion muss die Daten im entsprechenden Format zurückgeben. Haben Sie zum Beispiel
setDataHandler(ClipboardFormat.TEXT_FORMAT, writeText) aufgerufen, dann muss die Funktion
writeText() einen String zurückgeben.
Wird ein Datenformat desselben Typs mit der Methode setData() zum Clipboard-Objekt hinzugefügt, haben diese
Daten Vorrang vor der zurückgestellten Version (die Wiedergabefunktion wird nie aufgerufen). Möglicherweise wird
die Wiedergabefunktion aufgerufen, wenn auf dieselben Daten in der Zwischenablage ein zweites Mal zugegriffen wird.
Hinweis: Unter Mac OS X kann die verzögerte Darstellung nur an benutzerdefinierten Datenformaten ausgeführt
werden. Bei Standarddatenformaten wird die Darstellungsfunktion sofort aufgerufen.
Einfügen von Text mit zurückgestellter Wiedergabefunktion
Flash Player 10 und höher, Adobe AIR 1.0 und höher
Im folgenden Beispiel wird gezeigt, wie die Funktion für die zurückgestellte Wiedergabe eingesetzt wird.
Beim Klicken auf die Schaltfläche „Kopieren“ wird der Inhalt der Zwischenablage des Systems gelöscht, um
sicherzustellen, dass keine Daten von vorherigen Vorgängen in der Zwischenablage verbleiben. Anschließend wird
mithilfe der setDataHandler()-Methode die renderData()-Funktion als Darstellungsfunktion der Zwischenablage
eingestellt.
Wenn der Benutzer im Kontextmenü des Zieltextfelds den Befehl „Einfügen“ auswählt, greift die Anwendung auf die
Zwischenablage zu und legt den Zieltext fest. Da das Textdatenformat in der Zwischenablage nicht mit einem String
sondern einer Funktion eingestellt wurde, ruft die Zwischenablage die renderData()-Funktion auf. Die Funktion
renderData() gibt den Text im Quelltext zurück, der dann einem Zieltext zugeordnet wird.
Beachten Sie, das Bearbeitungsvorgänge am Quelltext vor dem Betätigen der Schaltfläche „Einfügen“ im eingefügten
Text sichtbar sind, auch wenn die Änderungen nach dem Betätigen der Schaltfläche „Kopieren“ getätigt wurden. Die
Wiedergabefunktion kopiert den Quelltext erst, wenn die Schaltfläche „Einfügen“ betätigt wird. (Bei Verwendung der
zurückgestellten Wiedergabe in einer echten Anwendung sollten Sie daher die Quelldaten möglicherweise speichern
oder schützen, um dieses Problem zu vermeiden.)
Letzte Aktualisierung 27.6.2012
638