Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Ziehen und Ablegen in AIR
Paket Klassen
flash.desktop NativeDragManager
NativeDragOptions
Clipboard
URLFilePromise
IFilePromise
Innerhalb der Drag & Drop-API verwendete Konstanten werden in den folgenden Klassen definiert:
NativeDragActions
ClipboardFormat
ClipboardTransferModes
flash.events NativeDragEvent
Phasen der Drag & Drop-Bewegungen
Die Drag & Drop-Bewegung setzt sich aus drei Phasen zusammen:
Initiation Der Benutzer initiiert eine Drag & Drop-Operation, indem er von einer Komponente oder einem Element in
einer Komponente aus zu Ziehen beginnt und dabei die Maustaste gedrückt hält. Die Komponente, aus der das gezogene
Element stammt, wird in der Regel mit „Ziehinitiator“ bezeichnet, denn sie löst die Ereignisse nativeDragStart und
nativeDragComplete aus. Eine Adobe AIR-Anwendung beginnt eine Ziehoperation, indem sie die Methode
NativeDragManager.doDrag() als Reaktion auf ein mouseDown- oder mouseMove-Ereignis aufruft.
Wenn die Ziehoperation außerhalb einer AIR-Anwendung eingeleitet wurde, gibt es kein Initiatorobjekt, das
nativeDragStart- oder nativeDragComplete-Ereignisse auslösen kann.
Ziehen Während die Maustaste noch gehalten wird, verschiebt der Benutzer den Mauscursor auf eine andere
Komponente, Anwendung oder den Desktop. Solange das Element gezogen wird, löst das Initiatorobjekt kontinuierlich
nativeDragUpdate-Ereignisse aus. (Dieses Ereignis wird in AIR für Linux nicht ausgelöst.) Wenn der Benutzer den
Mauscursor über ein mögliches Ablageziel in einer AIR-Anwendung führt, löst das Ablageziel ein nativeDragEnter-
Ereignis aus. Die Ereignisprozedur kann das Ereignisobjekt untersuchen, um festzustellen, ob die gezogenen Daten in
einem Format vorliegen, das vom Ziel akzeptiert wird. Ist dies der Fall, kann man dem Benutzer durch Aufruf der
Methode NativeDragManager.acceptDragDrop() die Möglichkeit zum Ablegen der Daten geben.
Solange die Ziehbewegung über einem interaktiven Objekt bleibt, löst dieses kontinuierlich nativeDragOver-
Ereignisse aus. Verlässt die Ziehbewegung das interaktive Objekt, löst es ein nativeDragExit-Ereignis aus.
Ablegen Der Benutzer lässt die Maustaste über dem gewünschten Ablageziel los. Handelt es sich bei dem Ziel um eine
AIR-Anwendung oder -Komponente, so löst das Zielobjekt ein nativeDragDrop-Ereignis aus. Die Ereignisprozedur
kann auf die übertragenen Daten aus dem Ereignisobjekt zugreifen. Befindet sich das Ziel außerhalb von AIR, wird die
Drop-Operation vom Betriebssystem oder von einer anderen Anwendung abgewickelt. In beiden Fällen löst das
initiierende Objekt ein nativeDragComplete-Ereignis aus (wenn die Ziehoperation aus AIR heraus gestartet wurde).
Die NativeDragManager-Klasse steuert sowohl das Hereinziehen als auch das Herausziehen. Alle Mitglieder der
NativeDragManager-Klasse sind statisch; erstellen Sie keine Instanz dieser Klasse.
Letzte Aktualisierung 27.6.2012
646