DragPrivate()

Syntax

Ergebnis = DragPrivate(Typ [, Aktionen])

Startet eine "private" Drag & Drop Operation. Anders als die anderen Funktionen zum Starten von Drag & Drop, können diese Daten nur innerhalb der Applikation wieder abgelegt werden (mittels Funktionen wie DragText() oder DragImage() "gezogene" Daten können auch von einer anderen Applikation akzeptiert werden). Diese Funktion sollte verwendet werden, um Drag & Drop Funktionalität mit Daten - welche nicht von anderen Applikationen verstanden werden - zwischen Gadgets oder Fenstern herzustellen.

Parameter

Typ

Typ kann jeder Ganzzahl-Wert (Integer) sein, welcher die in die Applikation zu ziehenden Daten identifiziert. Der gleiche Wert muss bei EnableGadgetDrop() oder EnableWindowDrop() für die Gadgets/Fenster angegeben werden, welche diese Daten akzeptieren sollen. Auf diesem Weg lässt sich exakt definieren, welche privaten "Drag"-Operationen von welchem Gadget/Fenster akzeptiert werden, was das Realisieren komplexer Drag & Drop Schemen ermöglicht.

Aktionen (optional)

Eine Kombination der Drag & Drop Aktionen, welche für die Daten erlaubt sein sollen. Wenn der Parameter nicht angegeben wird, wird #PB_Drag_Copy die einzige erlaubte Aktion sein. Mögliche Aktionen sind: (sie können mittels '|' kombiniert werden) #PB_Drag_Copy: Die Daten können kopiert werden #PB_Drag_Move: Die Daten können verschoben werden #PB_Drag_Link: Die Daten können verlinkt werden Der Anwender kann durch Drücken der Zusatztasten wie 'Strg' oder 'Shift' entscheiden, welche dieser Aktionen verwendet werden soll. Die Aktionen, welche tatsächlich stattfinden können, richten sich auch nach den vom Zielobjekt (englisch "drop target") erlaubten Aktionen.

Rückgabewert

Gibt einen der oben genannten Drag & Drop Aktions-Werte zurück, welche die vom Anwender genutzte Aktion anzeigen, oder #PB_Drag_None wenn der Anwender die Drag & Drop Operation abgebrochen hat.

Anmerkungen

Drag & Drop kann grundsätzlich jederzeit gestartet werden, aber die linke Maustaste sollte aktuell gedrückt sein, da andernfalls die Operation umgehend und ohne Erfolg beendet wird. Der übliche Zeitpunkt zum Starten einer Drag & Drop Operation ist, wenn ein Gadget über EventType() ein Ereignis vom Typ #PB_EventType_DragStart zurückmeldet.

Wenn die Operation nicht abgebrochen wurde, wird die Ereignis-Schleife ein #PB_Event_WindowDrop oder #PB_Event_GadgetDrop Ereignis vom Typ #PB_Drop_Private empfangen.

Siehe auch

DragText(), DragImage(), DragFiles(), DragOSFormats(), SetDragCallback()

Unterstützte OS

Windows, Linux