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 Gibt die PureBasic Fenster-Nummer des betreffenden Gadgets an.
Format Spezifiert das Daten-Format und kann einer der folgenden Werte oder eine OS-spezifische ID für ein anderes (custom) Format sein (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 Gibt eine Kombination der Drag & Drop Aktionen an, 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) Gibt den Typ des "privaten" Drag & Drop an, wenn #PB_Drop_Private als 'Format' akzeptiert wird. 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() ->