Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Ziehen und Ablegen in AIR
Weitere Informationen zu Formaten, die in der Zwischenablage verwendet werden können, finden Sie unter
„Datenformate in der Zwischenablage“ auf Seite 635.
Das folgende Beispiel illustriert die Erstellung eines Clipboard-Objekts, das eine Bitmap in mehreren Formaten
enthält: ein Bitmap-Objekt, ein natives Bitmap-Format und ein Dateilistenformat mit der Datei, aus der die Bitmap
ursprünglich geladen wurde:
import flash.desktop.Clipboard;
import flash.display.Bitmap;
import flash.filesystem.File;
public function createClipboard(image:Bitmap, sourceFile:File):Clipboard{
var transfer:Clipboard = new Clipboard();
transfer.setData("CUSTOM_BITMAP", image, true); //Flash object by value and by reference
transfer.setData(ClipboardFormats.BITMAP_FORMAT, image.bitmapData, false);
transfer.setData(ClipboardFormats.FILE_LIST_FORMAT, new Array(sourceFile), false);
return transfer;
}
Starten einer Herausziehoperation
Adobe AIR 1.0 und höher
Um eine Ziehoperation zu starten, rufen Sie als Reaktion auf ein mouseDown-Ereignis die Methode
NativeDragManager.doDrag() auf. Die doDrag()-Methode ist eine statische Methode, die die folgenden Parameter
akzeptiert:
Parameter Beschreibung
initiator Das Objekt, bei dem die Ziehbewegung anfing, und das die Ereignisse dragStart und dragComplete
auslöst. Der Initiator muss ein interaktives Objekt sein.
clipboard Das Clipboard-Objekt mit den zu übertragenden Daten. In den NativeDragEvent-Objekten, die während der
Drag & Drop-Sequenz ausgelöst wurden, wird auf das Clipboard-Objekt verwiesen.
dragImage (Optional) Ein BitmapData-Objekt, das beim Ziehen angezeigt wird. Das Bild kann einen alpha-Wert
angeben. (Hinweis: Unter Microsoft Windows wird den Ziehbildern immer ein fester Alphawert für die
Abblendung zugewiesen).
offset (Optional) Ein Point-Objekt, das den Versatz des Ziehbilds vom Maus-Hotspot angibt. Verwenden Sie negative
Koordinaten, um das Ziehbild in Relation zum Mauscursor nach oben und nach links zu versetzen. Wenn kein
Versatz angegeben ist, wird die obere linke Ecke des Ziehbilds am Maus-Hotspot positioniert.
actionsAllowed (Optional) Ein NativeDragOptions-Objekt, das festlegt, welche Aktionen (Kopieren, Verschieben oder
Verknüpfen) für die Ziehoperation zulässig sind. Wenn kein Argument angegeben wird, sind alle Aktionen
erlaubt. In den NativeDragEvent-Objekten wird auf das DragOptions-Objekt verwiesen, damit ein potentielles
Ablageziel überprüfen kann, ob die zulässigen Aktionen mit dem Zweck der Zielkomponente kompatibel
sind. Eine Papierkorbkomponente etwa wird wohl nur Ziehbewegungen akzeptieren, die ein Verschieben
erlauben.
Das folgende Beispiel zeigt, wie Sie eine Ziehoperation für ein aus einer Datei geladenes Bitmap-Objekt starten: Das
Beispiel lädt ein Bild und startet die Ziehoperation aufgrund eines mouseDown-Ereignisses.
Letzte Aktualisierung 27.6.2012
648