SetDragCallback()

Syntax

SetDragCallback(@DragCallback())

Definiert eine Callback-Funktion, welche während einer von dieser Applikation ausgelösten Drag & Drop Operation aufgerufen werden soll. Der Callback ermöglicht die Modifikation des von PureBasic angebotenen Drag & Drop Prozesses, z.B. durch die Aktivierung eines besonderen Mauscursors durch die API des Betriebssystems. Die Form und Funktion des Callbacks hängt vom OS ab und wird nachfolgend beschrieben:

Windows:

  Procedure DragCallback(Aktion)
  
    ProcedureReturn #True
  EndProcedure

Der Callback wird während der Drag & Drop Operation aufgerufen. 'Aktion' definiert die Aktion, welche stattfinden soll, wenn der Anwender an dieser Stelle den Mauscursor loslässt. Sie kann einer dieser Werte sein:

  #PB_Drag_None: Die Daten werden nicht akzeptiert, wenn sie hier abgelegt werden
  #PB_Drag_Copy: Die Daten werden kopiert
  #PB_Drag_Move: Die Daten werden verschoben
  #PB_Drag_Link: Die Daten werden verlinkt

Der Callback kann einen besonderen Mauscursor oder ein Verschiebebild anbieten. Wenn er dies tut, sollte er #False zurückgeben. Die Rückgabe von #True bewirkt, dass der standardmäßige Mauscursor verwendet wird.

Linux:

  Procedure DragCallback(*Context.GdkDragContext, isStart)
  
  EndProcedure

Der Callback wird nur zum Start und zum Ende einer Drag & Drop Operation aufgerufen. Der '*Context' Parameter gibt den "gdk drag context" dieser Operation an und 'isStart' spezifiert, ob dies der Start oder das Ende der Operation ist. Der Rückgabewert des Callbacks wird ignoriert.

Gtk Funktionen wie gtk_drag_set_icon_pixbuf_() können im Callback verwendet werden, um ein anderes Drag-Bild für die Operation zu definieren.

Unterstützte OS

Alle