cdk_drag_get_selection ()

CdkAtom
cdk_drag_get_selection (CdkDragContext *context);

Returns the selection atom for the current source window.

cdk_drag_abort ()

void
cdk_drag_abort (CdkDragContext *context,
                guint32 time_);

Aborts a drag without dropping.

This function is called by the drag source.

This function does not need to be called in managed drag and drop operations. See cdk_drag_context_manage_dnd() for more information.

cdk_drop_reply ()

void
cdk_drop_reply (CdkDragContext *context,
                gboolean accepted,
                guint32 time_);

Accepts or rejects a drop.

This function is called by the drag destination in response to a drop initiated by the drag source.

cdk_drag_drop ()

void
cdk_drag_drop (CdkDragContext *context,
               guint32 time_);

Drops on the current destination.

This function is called by the drag source.

This function does not need to be called in managed drag and drop operations. See cdk_drag_context_manage_dnd() for more information.

cdk_drag_drop_done ()

void
cdk_drag_drop_done (CdkDragContext *context,
                    gboolean success);

Inform CDK if the drop ended successfully. Passing FALSE for success may trigger a drag cancellation animation.

This function is called by the drag source, and should be the last call before dropping the reference to the context .

The CdkDragContext will only take the first cdk_drag_drop_done() call as effective, if this function is called multiple times, all subsequent calls will be ignored.

Since: 3.20

cdk_drag_find_window_for_screen ()

void
cdk_drag_find_window_for_screen (CdkDragContext *context,
                                 CdkWindow *drag_window,
                                 CdkScreen *screen,
                                 gint x_root,
                                 gint y_root,
                                 CdkWindow **dest_window,
                                 CdkDragProtocol *protocol);

Finds the destination window and DND protocol to use at the given pointer position.

This function is called by the drag source to obtain the dest_window and protocol parameters for cdk_drag_motion().

Since: 2.2

cdk_drag_begin ()

CdkDragContext *
cdk_drag_begin (CdkWindow *window,
                GList *targets);

Starts a drag and creates a new drag context for it. This function assumes that the drag is controlled by the client pointer device, use cdk_drag_begin_for_device() to begin a drag with a different device.

This function is called by the drag source.

cdk_drag_begin_for_device ()

CdkDragContext *
cdk_drag_begin_for_device (CdkWindow *window,
                           CdkDevice *device,
                           GList *targets);

Starts a drag and creates a new drag context for it.

This function is called by the drag source.

cdk_drag_begin_from_point ()

CdkDragContext *
cdk_drag_begin_from_point (CdkWindow *window,
                           CdkDevice *device,
                           GList *targets,
                           gint x_root,
                           gint y_root);

Starts a drag and creates a new drag context for it.

This function is called by the drag source.

Since: 3.20

cdk_drag_motion ()

gboolean
cdk_drag_motion (CdkDragContext *context,
                 CdkWindow *dest_window,
                 CdkDragProtocol protocol,
                 gint x_root,
                 gint y_root,
                 CdkDragAction suggested_action,
                 CdkDragAction possible_actions,
                 guint32 time_);

Updates the drag context when the pointer moves or the set of actions changes.

This function is called by the drag source.

This function does not need to be called in managed drag and drop operations. See cdk_drag_context_manage_dnd() for more information.

cdk_drop_finish ()

void
cdk_drop_finish (CdkDragContext *context,
                 gboolean success,
                 guint32 time_);

Ends the drag operation after a drop.

This function is called by the drag destination.

cdk_drag_status ()

void
cdk_drag_status (CdkDragContext *context,
                 CdkDragAction action,
                 guint32 time_);

Selects one of the actions offered by the drag source.

This function is called by the drag destination in response to cdk_drag_motion() called by the drag source.

cdk_drag_drop_succeeded ()

gboolean
cdk_drag_drop_succeeded (CdkDragContext *context);

Returns whether the dropped data has been successfully transferred. This function is intended to be used while handling a CDK_DROP_FINISHED event, its return value is meaningless at other times.

Since: 2.6

cdk_window_get_drag_protocol ()

CdkDragProtocol
cdk_window_get_drag_protocol (CdkWindow *window,
                              CdkWindow **target);

Finds out the DND protocol supported by a window.

Since: 3.0

cdk_drag_context_get_actions ()

CdkDragAction
cdk_drag_context_get_actions (CdkDragContext *context);

Determines the bitmask of actions proposed by the source if cdk_drag_context_get_suggested_action() returns CDK_ACTION_ASK.

Since: 2.22

cdk_drag_context_get_suggested_action ()

CdkDragAction
cdk_drag_context_get_suggested_action (CdkDragContext *context);

Determines the suggested drag action of the context.

Since: 2.22

cdk_drag_context_get_selected_action ()

CdkDragAction
cdk_drag_context_get_selected_action (CdkDragContext *context);

Determines the action chosen by the drag destination.

Since: 2.22

cdk_drag_context_list_targets ()

GList *
cdk_drag_context_list_targets (CdkDragContext *context);

Retrieves the list of targets of the context.

Since: 2.22

cdk_drag_context_get_device ()

CdkDevice *
cdk_drag_context_get_device (CdkDragContext *context);

Returns the CdkDevice associated to the drag context.

cdk_drag_context_set_device ()

void
cdk_drag_context_set_device (CdkDragContext *context,
                             CdkDevice *device);

Associates a CdkDevice to context , so all Drag and Drop events for context are emitted as if they came from this device.

cdk_drag_context_get_source_window ()

CdkWindow *
cdk_drag_context_get_source_window (CdkDragContext *context);

Returns the CdkWindow where the DND operation started.

Since: 2.22

cdk_drag_context_get_dest_window ()

CdkWindow *
cdk_drag_context_get_dest_window (CdkDragContext *context);

Returns the destination window for the DND operation.

Since: 3.0

cdk_drag_context_get_protocol ()

CdkDragProtocol
cdk_drag_context_get_protocol (CdkDragContext *context);

Returns the drag protocol that is used by this context.

Since: 3.0

cdk_drag_context_get_drag_window ()

CdkWindow *
cdk_drag_context_get_drag_window (CdkDragContext *context);

Returns the window on which the drag icon should be rendered during the drag operation. Note that the window may not be available until the drag operation has begun. CDK will move the window in accordance with the ongoing drag operation. The window is owned by context and will be destroyed when the drag operation is over.

Since: 3.20

cdk_drag_context_set_hotspot ()

void
cdk_drag_context_set_hotspot (CdkDragContext *context,
                              gint hot_x,
                              gint hot_y);

Sets the position of the drag window that will be kept under the cursor hotspot. Initially, the hotspot is at the top left corner of the drag window.

Since: 3.20

cdk_drag_context_manage_dnd ()

gboolean
cdk_drag_context_manage_dnd (CdkDragContext *context,
                             CdkWindow *ipc_window,
                             CdkDragAction actions);

Requests the drag and drop operation to be managed by context . When a drag and drop operation becomes managed, the CdkDragContext will internally handle all input and source-side CdkEventDND events as required by the windowing system.

Once the drag and drop operation is managed, the drag context will emit the following signals:

Since: 3.20

CdkDragContext

typedef struct _CdkDragContext CdkDragContext;

enum CdkDragCancelReason

Used in CdkDragContext to the reason of a cancelled DND operation.

Since: 3.20

enum CdkDragProtocol

Used in CdkDragContext to indicate the protocol according to which DND is done.

enum CdkDragAction

Used in CdkDragContext to indicate what the destination should do with the dropped data.

The “action-changed” signal

void
user_function (CdkDragContext *context,
               CdkDragAction   action,
               gpointer        user_data)

A new action is being chosen for the drag and drop operation.

This signal will only be emitted if the CdkDragContext manages the drag and drop operation. See cdk_drag_context_manage_dnd() for more information.

Flags: Run Last

Since: 3.20

The “cancel” signal

void
user_function (CdkDragContext     *context,
               CdkDragCancelReason reason,
               gpointer            user_data)

The drag and drop operation was cancelled.

This signal will only be emitted if the CdkDragContext manages the drag and drop operation. See cdk_drag_context_manage_dnd() for more information.

Flags: Run Last

Since: 3.20

The “dnd-finished” signal

void
user_function (CdkDragContext *context,
               gpointer        user_data)

The drag and drop operation was finished, the drag destination finished reading all data. The drag source can now free all miscellaneous data.

This signal will only be emitted if the CdkDragContext manages the drag and drop operation. See cdk_drag_context_manage_dnd() for more information.

Flags: Run Last

Since: 3.20

The “drop-performed” signal

void
user_function (CdkDragContext *context,
               int             time,
               gpointer        user_data)

The drag and drop operation was performed on an accepting client.

This signal will only be emitted if the CdkDragContext manages the drag and drop operation. See cdk_drag_context_manage_dnd() for more information.

Flags: Run Last

Since: 3.20