Gdk.DragContext¶

Subclasses:: None

Methods¶

Inherited:: GObject.Object (37)
Structs:: GObject.ObjectClass (5)

	`finish` (success, del_, time)
	`get_actions` ()
	`get_dest_window` ()
	`get_device` ()
	`get_drag_window` ()
	`get_protocol` ()
	`get_selected_action` ()
	`get_source_window` ()
	`get_suggested_action` ()
	`list_targets` ()
	`manage_dnd` (ipc_window, actions)
	`set_device` (device)
	`set_hotspot` (hot_x, hot_y)

Virtual Methods¶

Inherited:: GObject.Object (7)

Properties¶

None

Signals¶

Inherited:: GObject.Object (1)

Name	Short Description
`action-changed`	A new action is being chosen for the drag and drop operation.
`cancel`	The drag and drop operation was cancelled.
`dnd-finished`	The drag and drop operation was finished, the drag destination finished reading all data.
`drop-performed`	The drag and drop operation was performed on an accepting client.

Fields¶

Inherited:: GObject.Object (1)

Class Details¶

class Gdk.DragContext(**kwargs)¶

Bases:: GObject.Object
Abstract:: No

finish(success, del_, time)¶

get_actions()[source]¶

Returns:: the Gdk.DragAction flags
Return type:: Gdk.DragAction

Determines the bitmask of actions proposed by the source if Gdk.DragContext.get_suggested_action() returns Gdk.DragAction.ASK.

New in version 2.22.

get_dest_window()[source]¶

Returns:: a Gdk.Window
Return type:: Gdk.Window

Returns the destination window for the DND operation.

New in version 3.0.

get_device()[source]¶

Returns:: The Gdk.Device associated to self.
Return type:: Gdk.Device

Returns the Gdk.Device associated to the drag context.

get_drag_window()[source]¶

Returns:: the drag window, or None
Return type:: Gdk.Window or None

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. GDK will move the window in accordance with the ongoing drag operation. The window is owned by self and will be destroyed when the drag operation is over.

New in version 3.20.

get_protocol()[source]¶

Returns:: the drag protocol
Return type:: Gdk.DragProtocol

Returns the drag protocol that is used by this context.

New in version 3.0.

get_selected_action()[source]¶

Returns:: a Gdk.DragAction value
Return type:: Gdk.DragAction

Determines the action chosen by the drag destination.

New in version 2.22.

get_source_window()[source]¶

Returns:: a Gdk.Window
Return type:: Gdk.Window

Returns the Gdk.Window where the DND operation started.

New in version 2.22.

get_suggested_action()[source]¶

Returns:: a Gdk.DragAction value
Return type:: Gdk.DragAction

Determines the suggested drag action of the context.

New in version 2.22.

list_targets()[source]¶

Returns:: a GLib.List of targets
Return type:: [Gdk.Atom]

Retrieves the list of targets of the context.

New in version 2.22.

manage_dnd(ipc_window, actions)[source]¶

Parameters:

ipc_window (Gdk.Window) – Window to use for IPC messaging/events
actions (Gdk.DragAction) – the actions supported by the drag source

Returns:

True if the drag and drop operation is managed.

Return type:

bool

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

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

The Gdk.DragContext ::action-changed signal whenever the final action to be performed by the drag and drop operation changes.
The Gdk.DragContext ::drop-performed signal after the user performs the drag and drop gesture (typically by releasing the mouse button).
The Gdk.DragContext ::dnd-finished signal after the drag and drop operation concludes (after all #GdkSelection transfers happen).
The Gdk.DragContext ::cancel signal if the drag and drop operation is finished but doesn’t happen over an accepting destination, or is cancelled through other means.

New in version 3.20.

set_device(device)[source]¶

Parameters:: device (Gdk.Device) – a Gdk.Device

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

set_hotspot(hot_x, hot_y)[source]¶

Parameters:

hot_x (int) – x coordinate of the drag window hotspot
hot_y (int) – y coordinate of the drag window hotspot

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.

New in version 3.20.

Signal Details¶

Gdk.DragContext.signals.action_changed(drag_context, action)¶

Signal Name:

action-changed

Flags:

RUN_LAST

Parameters:

drag_context (Gdk.DragContext) – The object which received the signal
action (Gdk.DragAction) – The action currently chosen

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

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

New in version 3.20.

Gdk.DragContext.signals.cancel(drag_context, reason)¶

Signal Name:

cancel

Flags:

RUN_LAST

Parameters:

drag_context (Gdk.DragContext) – The object which received the signal
reason (Gdk.DragCancelReason) – The reason the context was cancelled

The drag and drop operation was cancelled.

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

New in version 3.20.

Gdk.DragContext.signals.dnd_finished(drag_context)¶

Signal Name:: dnd-finished
Flags:: RUN_LAST
Parameters:: drag_context (Gdk.DragContext) – The object which received the signal

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 Gdk.DragContext manages the drag and drop operation. See Gdk.DragContext.manage_dnd() for more information.

New in version 3.20.

Gdk.DragContext.signals.drop_performed(drag_context, time)¶

Signal Name:

drop-performed

Flags:

RUN_LAST

Parameters:

drag_context (Gdk.DragContext) – The object which received the signal
time (int) – the time at which the drop happened.

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

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

New in version 3.20.