SetDragCallback()

Syntax

SetDragCallback(@DragCallback())
Beschreibung
Gibt eine Callback-Funktion an, 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.

Parameter

@DragCallback() Die Adresse einer Funktion, welche während einer Drag-Operation (das Objekt wird "gezogen") aufgerufen wird.

Die Form und Funktion des Callbacks hängt vom OS ab. Dieser muss folgende Form haben:

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 ("drag image") 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' spezifiziert, 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 Verschiebebild ("drag image") für die Operation zu definieren.
MacOSX: 
  Procedure DragCallback(DragReference, isStart)
  
  EndProcedure
Der Callback wird nur zum Start und zum Ende einer Drag & Drop Operation aufgerufen. Der 'DragReference' Parameter gibt den "Carbon drag context" dieser Operation in Form eines 'DragRef' Wertes an und 'isStart' spezifiziert, ob dies der Start oder das Ende der Operation ist. Der Rückgabewert des Callbacks wird ignoriert.

Alle Funktionen des Carbon Drag Managers können verwendet werden, um die Drag-Operation vor ihrem Start zu beeinflussen (weitere Einträge/"Flavors" hinzufügen zum Beispiel), und um weitere Informationen über die Operation zu erhalten, nachdem sie abgeschlossen wurde.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Siehe auch

SetDropCallback()

Unterstützte OS

Alle

<- EventDropY() - DragDrop Inhaltsverzeichnis - SetDropCallback() ->