EnableGadgetDrop()

Syntax

EnableGadgetDrop(#Gadget, Format, Aktionen [, PrivatTyp])

Aktiviert ein Gadget, um als Ziel für Drag & Drop Operationen eines bestimmten Formats zu dienen. Wenn der Anwender Daten diesen Formats über das Gadget zieht, wird der Mauscursor anzeigen, dass die Daten hier abgelegt ("fallen gelassen") werden können.

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

Parameter

#Gadget ist die PureBasic Gadget Nummer des betreffenden Gadgets.

Format gibt das Daten-Format an und kann einer der folgenden Werte oder eine OS-spezifische ID für anderes (custom) Format sein (siehe DragOSFormats() für weitere Informationen).

  #PB_Drop_Text   : Akzeptiere Text auf diesem Gadget
  #PB_Drop_Image  : Akzeptiere Bilder auf diesem Gadget
  #PB_Drop_Files  : Akzeptiere Dateinamen auf diesem Gadget
  #PB_Drop_Private: Akzeptiere ein "privates" Drag & Drop auf diesem Gadget

Aktionen kann eine Kombination der Drag & Drop Aktionen sein, 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 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' wird nur benötigt, wenn #PB_Drop_Private als Format angegeben wird. Es gibt den Typ des privaten Drag & Drop an, welches akzeptiert werden soll. Siehe DragPrivate() für weitere Informationen.

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

Unterstützte OS

Alle