Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Ziehen und Ablegen in AIR
Wichtig: Nur Code, der in der Anwendungs-Sandbox ausgeführt wird, kann auf abgelegte Dateien zugreifen. Der
Versuch, Eigenschaften eines File-Objekts innerhalb einer anwendungsfremden Sandbox zu lesen oder zu setzen, erzeugt
einen Sicherheitsfehler. Weitere Informationen finden Sie unter „Abgelegte Dateien in anwendungsfremden HTML-
Sandboxen“ auf Seite 660.
Zieheffekte in HTML
Adobe AIR 1.0 und höher
Der Initiator der Ziehbewegung kann die zugelassenen Zieheffekte einschränken, indem er die Eigenschaft
dataTransfer.effectAllowed in der Prozedur für das dragstart-Ereignis setzt. Es können die folgenden
Stringwerte verwendet werden:
Stringwert Beschreibung
"none" Es sind keine Ziehoperationen zugelassen.
"copy" Die Daten werden in das Ziel kopiert, bleiben aber auch am Herkunftsort erhalten.
"link" Die Daten werden gemeinsam mit dem Ziel genutzt, indem eine Verknüpfung zum Herkunftsort erstellt wird.
"move” Die Daten werden vom Herkunftsort entfernt und in das Ziel kopiert.
"copyLink" Die Daten können kopiert oder verknüpft werden.
"copyMove" Die Daten können kopiert oder verschoben werden.
"linkMove" Die Daten können verknüpft oder verschoben werden.
"all" Die Daten können kopiert, verschoben oder verknüpft werden. all ist der Standardeffekt, wenn Sie das
Standardverhalten deaktiviert haben.
Vom Ziel der Ziehbewegung kann in der Eigenschaft dataTransfer.dropEffect festgelegt werden, welche Aktion
durchgeführt wird, wenn der Benutzer den Ablegvorgang abschließt. Ist der Ablegeffekt eine der zulässigen Aktionen,
zeigt das System den entsprechenden Kopier-, Verschieb- oder Verknüpfcursor an. Andernfalls zeigt das System den
Nicht-verfügbar-Cursor an. Wenn vom Ziel kein Ablegeffekt eingestellt wurde, kann der Benutzer mithilfe der
Zusatztasten aus den zulässigen Aktionen einen Effekt auswählen.
Den dropEffect-Wert legen Sie in den Prozeduren für die Ereignisse dragover und dragenter fest:
function doDragStart(event) {
event.dataTransfer.setData("text/plain","Text to drag");
event.dataTransfer.effectAllowed = "copyMove";
}
function doDragOver(event) {
event.dataTransfer.dropEffect = "copy";
}
function doDragEnter(event) {
event.dataTransfer.dropEffect = "copy";
}
Hinweis: Obwohl Sie die Eigenschaft dropEffect in der Prozedur für dragenter immer einstellen sollten, müssen Sie
sich im Klaren darüber sein, dass das nächste dragover-Ereignis die Eigenschaft auf ihren Standardwert zurücksetzt.
Legen Sie daher als Reaktion auf beide Ereignisse einen dropEffect-Wert fest.
Letzte Aktualisierung 27.6.2012
656