Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Ziehen und Ablegen in AIR
4 Der NativeDragManager ändert den Mauscursor, um anzuzeigen, dass das Objekt abgelegt werden kann.
5 Der Benutzer legt das Objekt über eine Komponente ab.
6 Die empfangende Komponente löst ein nativeDragDrop-Ereignis aus.
7 Die empfangende Komponente liest die Daten im gewünschten Format aus dem Clipboard-Objekt innerhalb des
Ereignisobjekts.
8 Hat die Ziehbewegung ihren Ursprung in einer AIR-Anwendung, löst das initiierende interaktive Objekt ein
nativeDragComplete-Ereignis aus. Hat die Ziehbewegung ihren Ursprung außerhalb von AIR, wird keine
Rückmeldung gesendet.
Bestätigen des Hineinziehens
Adobe AIR 1.0 und höher
Wenn ein Benutzer ein Zwischenablageelement in eine visuelle Komponente hineinzieht, löst die Komponente
nativeDragEnter- und nativeDragOver-Ereignisse aus. Um zu bestimmen, ob die Komponente das
Zwischenablageelement akzeptieren kann, können die Prozeduren für diese Ereignisse die Eigenschaften clipboard
und allowedActions dieses Ereignisobjekts überprüfen. Um zu signalisieren, dass die Komponente das abzulegende
Element akzeptieren kann, muss die Ereignisprozedur die Methode NativeDragManager.acceptDragDrop()
aufrufen und einen Verweis an die empfangende Komponente übergeben. Wenn mehrere registrierte Ereignis-
Listener die acceptDragDrop()-Methode aufrufen, hat die letzte Prozedur in der Liste den Vorrang. Der
acceptDragDrop()-Aufruf bleibt gültig, bis der Mauscursor die Grenzen des empfangenden Objekts verlässt und
dabei das nativeDragExit-Ereignis auslöst.
Wenn im allowedActions-Parameter, der an doDrag() übergeben wurde, mehrere Aktionen zugelassen sind, kann
der Benutzer auswählen, welche der zulässigen Aktionen durchgeführt werden soll, indem er eine Zusatztaste drückt.
Der Ziehmanager ändert das Cursorbild, um dem Benutzer mitzuteilen, welche Aktion ausgeführt wird, wenn er die
Ziehoperation abschließt. Die beabsichtigte Aktion wird von der dropAction-Eigenschaft des NativeDragEvent-
Objekts gemeldet. Die für eine Ziehbewegung eingestellte Aktion ist nur ein Vorschlag. Die an der Übertragung
beteiligten Komponenten müssen das entsprechende Verhalten implementieren. Um beispielsweise eine
Verschiebaktion abzuschließen, würde die Ursprungsanwendung (der Ziehinitiator) das gezogene Element wohl
entfernen und das Ablageziel würde es hinzufügen.
Die Zielanwendung kann die Ablegaktion auf drei mögliche Aktionen begrenzen, indem sie die dropAction-
Eigenschaft der NativeDragManager-Klasse setzt. Wenn ein Benutzer versucht, über die Tastatur eine andere Aktion
zu wählen, zeigt der NativeDragManager den Nicht-verfügbar-Cursor an. Setzen Sie die Eigenschaft dropAction in
den Prozeduren, und zwar sowohl für das Ereignis nativeDragEnter als auch für das Ereignis nativeDragOver.
Das folgende Beispiel präsentiert eine Ereignisprozedur für ein nativeDragEnter- oder nativeDragOver-Ereignis.
Diese Prozedur akzeptiert eine Hineinziehbewegung, wenn die gezogene Zwischenablage Daten im Textformat
enthält.
import flash.desktop.NativeDragManager;
import flash.events.NativeDragEvent;
public function onDragIn(event:NativeDragEvent):void{
NativeDragManager.dropAction = NativeDragActions.MOVE;
if(event.clipboard.hasFormat(ClipboardFormats.TEXT_FORMAT)){
NativeDragManager.acceptDragDrop(this); //'this' is the receiving component
}
}
Letzte Aktualisierung 27.6.2012
651