EnableWindowDrop()

Syntax

EnableWindowDrop(#Window, Format, Aktionen [, PrivatTyp])
Beschreibung
Aktiviert ein Fenster, um als Ziel für Drag & Drop Operationen eines bestimmten Formats zu dienen. Nur der Bereich des Fensters, welcher nicht mit Gadgets belegt ist, wird der Zielbereich sein. Wenn der Anwender Daten diesen Formats über das Fenster zieht, wird der Mauscursor anzeigen, dass die Daten hier abgelegt ("fallen gelassen") werden können.

Parameter

#Window Die PureBasic Fenster-Nummer des betreffenden Fensters.
Format Das Daten-Format, welches einer der folgenden Werte oder eine OS-spezifische ID für ein anderes (custom) Format sein kann (siehe DragOSFormats() für weitere Informationen).
  #PB_Drop_Text   : Akzeptiere Text auf diesem Fenster
  #PB_Drop_Image  : Akzeptiere Bilder auf diesem Fenster
  #PB_Drop_Files  : Akzeptiere Dateinamen auf diesem Fenster
  #PB_Drop_Private: Akzeptiere ein "privates" Drag & Drop auf diesem Fenster
Aktionen Eine Kombination der Drag & Drop Aktionen, welche für die Daten erlaubt sein sollen. 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 Quellobjekt (englisch "Drag object") erlaubten Aktionen. Mögliche Aktionen sind: (sie können mittels '|' kombiniert werden)
  #PB_Drag_None: Das Daten-Format wird auf diesem Gadget nicht akzeptiert
  #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
PrivatTyp (optional) Der Typ des zu akzeptierenden "privaten" Drag & Drop, wenn 'Format' gleich #PB_Drop_Private ist. Siehe DragPrivate() für weitere Informationen. Dieser Parameter wird bei anderen Formaten ignoriert.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Mehrere Formate können auf dem gleichen Fenster erlaubt sein. Wenn die Quelle der Verschiebe-Operation mehrere Formate anbietet, welche zur Liste der akzeptierten Formate passen, dann wird das zuletzt hinzugefügte akzeptiert. Daher sollte das bevorzugte Format, in welchem Daten empfangen werden, zuletzt aktiviert werden.

Wenn Daten auf dem Fenster abgelegt wurden, wird das Programm ein #PB_Event_WindowDrop Ereignis empfangen. EventWindow() wird das Ziel-Fenster anzeigen und die Event-Funktionen dieser Bibliothek können zum Ermitteln der abgelegten Daten verwendet werden.

Siehe auch

EnableGadgetDrop(), EventDropType(), EventDropAction(), SetDropCallback()

Unterstützte OS

Alle

<- EnableGadgetDrop() - DragDrop Inhaltsverzeichnis - EventDropAction() ->