GI.Gdk.Objects.Drop

The GdkDrop struct contains only private fields and should not be accessed directly.

Exported types

newtype Drop

Memory-managed wrapper type.

Constructors

Drop (ManagedPtr Drop)

Instances

Eq Drop

Defined in GI.Gdk.Objects.Drop

Methods

(==) :: Drop -> Drop -> Bool

(/=) :: Drop -> Drop -> Bool

GObject Drop

Defined in GI.Gdk.Objects.Drop

ManagedPtrNewtype Drop

Defined in GI.Gdk.Objects.Drop

Methods

toManagedPtr :: Drop -> ManagedPtr Drop

TypedObject Drop

Defined in GI.Gdk.Objects.Drop

Methods

glibType :: IO GType

HasParentTypes Drop

Defined in GI.Gdk.Objects.Drop

IsGValue (Maybe Drop)

Convert Drop to and from GValue. See toGValue and fromGValue.

Defined in GI.Gdk.Objects.Drop

Methods

gvalueGType_ :: IO GType

gvalueSet_ :: Ptr GValue -> Maybe Drop -> IO ()

gvalueGet_ :: Ptr GValue -> IO (Maybe Drop)

type ParentTypes Drop

Defined in GI.Gdk.Objects.Drop

type ParentTypes Drop = '[Object]

class (GObject o, IsDescendantOf Drop o) => IsDrop o

Type class for types which can be safely cast to Drop, for instance with toDrop.

Instances

(GObject o, IsDescendantOf Drop o) => IsDrop o

Defined in GI.Gdk.Objects.Drop

toDrop :: (MonadIO m, IsDrop o) => o -> m Drop

Cast to Drop, for types for which this is known to be safe. For general casts, use castTo.

Methods

Click to display all available methods, including inherited ones

Methods

bindProperty, bindPropertyFull, finish, forceFloating, freezeNotify, getv, isFloating, notify, notifyByPspec, readAsync, readFinish, readValueAsync, readValueFinish, ref, refSink, runDispose, status, stealData, stealQdata, thawNotify, unref, watchClosure.

Getters

getActions, getData, getDevice, getDisplay, getDrag, getFormats, getProperty, getQdata, getSurface.

Setters

setData, setDataFull, setProperty.

finish

dropFinish

Arguments

:: (HasCallStack, MonadIO m, IsDrop a)

=> a

self: a Drop

-> [DragAction]

action: the action performed by the destination or 0 if the drop failed

-> m ()

Ends the drag operation after a drop.

The action must be a single action selected from the actions available via dropGetActions.

getActions

dropGetActions

Arguments

:: (HasCallStack, MonadIO m, IsDrop a)

=> a

self: a Drop

-> m [DragAction]

Returns: The possible GdkDragActions

Returns the possible actions for this Drop. If this value contains multiple actions - ie dragActionIsUnique returns False for the result - dropFinish must choose the action to use when accepting the drop. This will only happen if you passed DragActionAsk as one of the possible actions in dropStatus. DragActionAsk itself will not be included in the actions returned by this function.

This value may change over the lifetime of the Drop both as a response to source side actions as well as to calls to dropStatus or dropFinish. The source side will not change this value anymore once a drop has started.

getDevice

dropGetDevice

Arguments

:: (HasCallStack, MonadIO m, IsDrop a)

=> a

self: a Drop

-> m Device

Returns: The Device performing the drop.

Returns the Device performing the drop.

getDisplay

dropGetDisplay

Arguments

:: (HasCallStack, MonadIO m, IsDrop a)

=> a

self: a Drop

-> m Display

Returns: a Display

Gets the Display that self was created for.

getDrag

dropGetDrag

Arguments

:: (HasCallStack, MonadIO m, IsDrop a)

=> a

self: a Drop

-> m (Maybe Drag)

Returns: the corresponding Drag

If this is an in-app drag-and-drop operation, returns the Drag that corresponds to this drop.

If it is not, Nothing is returned.

getFormats

dropGetFormats

Arguments

:: (HasCallStack, MonadIO m, IsDrop a)

=> a

self: a Drop

-> m ContentFormats

Returns: The possible ContentFormats

Returns the ContentFormats that the drop offers the data to be read in.

getSurface

dropGetSurface

Arguments

:: (HasCallStack, MonadIO m, IsDrop a)

=> a

self: a Drop

-> m Surface

Returns: The Surface performing the drop.

Returns the Surface performing the drop.

readAsync

dropReadAsync

Arguments

:: (HasCallStack, MonadIO m, IsDrop a, IsCancellable b)

=> a

self: a Drop

-> [Text]

mimeTypes: pointer to an array of mime types

-> Int32

ioPriority: the io priority for the read operation

-> Maybe b

cancellable: optional Cancellable object, Nothing to ignore

-> Maybe AsyncReadyCallback

callback: a AsyncReadyCallback to call when the request is satisfied

-> m ()

Asynchronously read the dropped data from a Drop in a format that complies with one of the mime types.

readFinish

dropReadFinish

Arguments

:: (HasCallStack, MonadIO m, IsDrop a, IsAsyncResult b)

=> a

self: a Drop

-> b

result: a AsyncResult

-> m (Maybe InputStream, Text)

Returns: the InputStream, or Nothing (Can throw GError)

Finishes an async drop read operation, see dropReadAsync.

readValueAsync

dropReadValueAsync

Arguments

:: (HasCallStack, MonadIO m, IsDrop a, IsCancellable b)

=> a

self: a Drop

-> GType

type: a GType to read

-> Int32

ioPriority: the [I/O priority][io-priority] of the request.

-> Maybe b

cancellable: optional Cancellable object, Nothing to ignore.

-> Maybe AsyncReadyCallback

callback: callback to call when the request is satisfied

-> m ()

Asynchronously request the drag operation's contents converted to the given type. When the operation is finished callback will be called. You can then call dropReadValueFinish to get the resulting Value.

For local drag'n'drop operations that are available in the given GType, the value will be copied directly. Otherwise, GDK will try to use contentDeserializeAsync to convert the data.

readValueFinish

dropReadValueFinish

Arguments

:: (HasCallStack, MonadIO m, IsDrop a, IsAsyncResult b)

=> a

self: a Drop

-> b

result: a AsyncResult

-> m GValue

Returns: a Value containing the result. (Can throw GError)

Finishes an async drop read started with dropReadValueAsync.

status

dropStatus

Arguments

:: (HasCallStack, MonadIO m, IsDrop a)

=> a

self: a Drop

-> [DragAction]

actions: Supported actions of the destination, or 0 to indicate that a drop will not be accepted

-> [DragAction]

preferred: A unique action that's a member of actions indicating the preferred action.

-> m ()

Selects all actions that are potentially supported by the destination.

When calling this function, do not restrict the passed in actions to the ones provided by dropGetActions. Those actions may change in the future, even depending on the actions you provide here.

The preferred action is a hint to the drag'n'drop mechanism about which action to use when multiple actions are possible.

This function should be called by drag destinations in response to EventTypeDragEnter or EventTypeDragMotion events. If the destination does not yet know the exact actions it supports, it should set any possible actions first and then later call this function again.

Properties

actions

The possible actions for this drop

constructDropActions :: (IsDrop o, MonadIO m) => [DragAction] -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “actions” property. This is rarely needed directly, but it is used by new.

getDropActions :: (MonadIO m, IsDrop o) => o -> m [DragAction]

Get the value of the “actions” property. When overloading is enabled, this is equivalent to

get drop #actions

device

The Device performing the drop

constructDropDevice :: (IsDrop o, MonadIO m, IsDevice a) => a -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “device” property. This is rarely needed directly, but it is used by new.

getDropDevice :: (MonadIO m, IsDrop o) => o -> m Device

Get the value of the “device” property. When overloading is enabled, this is equivalent to

get drop #device

display

The Display that the drop belongs to.

getDropDisplay :: (MonadIO m, IsDrop o) => o -> m Display

Get the value of the “display” property. When overloading is enabled, this is equivalent to

get drop #display

drag

The Drag that initiated this drop

constructDropDrag :: (IsDrop o, MonadIO m, IsDrag a) => a -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “drag” property. This is rarely needed directly, but it is used by new.

getDropDrag :: (MonadIO m, IsDrop o) => o -> m (Maybe Drag)

Get the value of the “drag” property. When overloading is enabled, this is equivalent to

get drop #drag

formats

The possible formats that the drop can provide its data in.

constructDropFormats :: (IsDrop o, MonadIO m) => ContentFormats -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “formats” property. This is rarely needed directly, but it is used by new.

getDropFormats :: (MonadIO m, IsDrop o) => o -> m ContentFormats

Get the value of the “formats” property. When overloading is enabled, this is equivalent to

get drop #formats

surface

The Surface the drop happens on

constructDropSurface :: (IsDrop o, MonadIO m, IsSurface a) => a -> m (GValueConstruct o)

Construct a GValueConstruct with valid value for the “surface” property. This is rarely needed directly, but it is used by new.

getDropSurface :: (MonadIO m, IsDrop o) => o -> m Surface

Get the value of the “surface” property. When overloading is enabled, this is equivalent to

get drop #surface