Drag

Object Hierarchy:

Description:

[ CCode ( type_id = "gdk_drag_get_type ()" ) ]
public abstract class Drag : Object

The `GdkDrag` object represents the source of an ongoing DND operation.

A `GdkDrag` is created when a drag is started, and stays alive for duration of the DND operation. After a drag has been started with [ func@Gdk.Drag.begin], the caller gets informed about the status of the ongoing drag operation with signals on the `GdkDrag` object.

GTK provides a higher level abstraction based on top of these functions, and so they are not normally needed in GTK applications. See the "Drag and Drop" section of the GTK documentation for more information.

Namespace: Gdk

Package: gtk4

Content:

Properties:

public DragAction actions { get; set; }
The possible actions of this drag.
public ContentProvider content { get; construct; }
The `GdkContentProvider`.
public Device device { get; construct; }
The `GdkDevice` that is performing the drag.
public Display display { get; }
The `GdkDisplay` that the drag belongs to.
public ContentFormats formats { get; construct; }
The possible formats that the drag can provide its data in.
public DragAction selected_action { get; set; }
The currently selected action of the drag.
public Surface surface { get; construct; }
The surface where the drag originates.

Static methods:

public static Drag? begin (Surface surface, Device device, ContentProvider content, DragAction actions, double dx, double dy)
Starts a drag and creates a new drag context for it.

Creation methods:

protected Drag ()

Methods:

public void drop_done (bool success)
Informs GDK that the drop ended.
public DragAction get_actions ()
Determines the bitmask of possible actions proposed by the source.
public unowned ContentProvider get_content ()
Returns the `GdkContentProvider` associated to the `GdkDrag` object.
public unowned Device get_device ()
Returns the `GdkDevice` associated to the `GdkDrag` object.
public unowned Display get_display ()
Gets the `GdkDisplay` that the drag object was created for.
public unowned Surface? get_drag_surface ()
Returns the surface on which the drag icon should be rendered during the drag operation.
public unowned ContentFormats get_formats ()
Retrieves the formats supported by this `GdkDrag` object.
public DragAction get_selected_action ()
Determines the action chosen by the drag destination.
public unowned Surface get_surface ()
Returns the `GdkSurface` where the drag originates.
public void set_hotspot (int hot_x, int hot_y)
Sets the position of the drag surface that will be kept under the cursor hotspot.

Signals:

public signal void cancel (DragCancelReason reason)
Emitted when the drag operation is cancelled.
public signal void dnd_finished ()
Emitted when the destination side has finished reading all data.
public signal void drop_performed ()
Emitted when the drop operation is performed on an accepting client.

Inherited Members:

All known members inherited from class GLib.Object