GtkDropTargetAsync

gtk_drop_target_async_new ()

GtkDropTargetAsync *
gtk_drop_target_async_new (GdkContentFormats *formats,
                           GdkDragAction actions);

Создаёт новый объект GtkDropTargetAsync.

gtk_drop_target_async_set_formats ()

void
gtk_drop_target_async_set_formats (GtkDropTargetAsync *self,
                                   GdkContentFormats *formats);

Устанавливает форматы данных, которые будет принимать данный целевой объект.

gtk_drop_target_async_get_formats ()

GdkContentFormats *
gtk_drop_target_async_get_formats (GtkDropTargetAsync *self);

Получает форматы данных, которые принимает данный целевой объект.

Если результат NULL, все форматы предполагаются поддерживаемыми.

gtk_drop_target_async_set_actions ()

void
gtk_drop_target_async_set_actions (GtkDropTargetAsync *self,
                                   GdkDragAction actions);

Устанавливает действия, которые поддерживает этот целевой объект.

gtk_drop_target_async_get_actions ()

GdkDragAction
gtk_drop_target_async_get_actions (GtkDropTargetAsync *self);

Получает действия, которые поддерживает этот целевой объект.

gtk_drop_target_async_reject_drop ()

void
gtk_drop_target_async_reject_drop (GtkDropTargetAsync *self,
                                   GdkDrop *drop);

Устанавливает drop как не принятое в данном месте перетаскивания.

Эта функция должна использоваться при отложенном принятии или отклонении перетаскивания до получения данных.

GtkDropTargetAsync

typedef struct _GtkDropTargetAsync GtkDropTargetAsync;

Свойство “actions”

  “actions”                  GdkDragAction

Поддерживаемые GdkDragActions действия.

Владелец: GtkDropTargetAsync

Флаги: Чтение / Запись

Свойство “formats”

  “formats”                  GdkContentFormats *

Форматы данных GdkContentFormats, определяющие поддерживаемые форматы.

Владелец: GtkDropTargetAsync

Флаги: Чтение / Запись

Сигнал “accept”

gboolean
user_function (GtkDropTargetAsync *self,
               GdkDrop            *drop,
               gpointer            user_data)

Сигнал ::accept генерируется в точке приема, когда операция переноса данных (drop) вот-вот начнется.

Если перенос не принят, будет возвращено FALSE, и целевой объект переноса проигнорирует операцию. Если возвращено TRUE, перенос принят временно, но может быть отклонен позже с помощью вызова gtk_drop_target_async_reject() или в конечном итоге возвращением значения FALSE из “drop”.

Обработчик по умолчанию для этого сигнала определяет, принимать ли перенос, основываясь на форматах, предоставленных drop.

Если для принятия или отклонения переноса требуется дополнительная обработка, например, проверка данных, эта функция должна вернуть TRUE и продолжить, как если бы drop был принят; если перенос необходимо отклонить, следует вызвать gtk_drop_target_async_reject_drop().

Флаги: Run Last

Сигнал “drag-enter”

GdkDragAction
user_function (GtkDropTargetAsync *self,
               GdkDrop            *drop,
               double              x,
               double              y,
               gpointer            user_data)

Сигнал ::drag-enter генерируется в точке приема, когда указатель мыши входит в виджет. Он может использоваться для настройки пользовательского выделения.

Флаги: Run Last

Сигнал “drag-leave”

void
user_function (GtkDropTargetAsync *self,
               GdkDrop            *drop,
               gpointer            user_data)

Сигнал ::drag-leave генерируется в точке приема, когда указатель мыши покидает виджет. Его основная цель — отменить действия, выполненные в “drag-enter”.

Флаги: Run Last

Сигнал “drag-motion”

GdkDragAction
user_function (GtkDropTargetAsync *self,
               GdkDrop            *drop,
               double              x,
               double              y,
               gpointer            user_data)

Сигнал ::drag-motion генерируется, пока указатель находится над целевым объектом переноса.

Флаги: Run Last

Сигнал “drop”

gboolean
user_function (GtkDropTargetAsync *self,
               GdkDrop            *drop,
               double              x,
               double              y,
               gpointer            user_data)

Сигнал ::drop генерируется в точке приема, когда пользователь опускает данные на виджет. Обработчик сигнала должен определить, находится ли позиция указателя в зоне приема. Если нет, он возвращает FALSE, и дальнейшая обработка не требуется.

В противном случае обработчик возвращает TRUE. В этом случае обработчик примет перенос. Обработчик должен убедиться, что вызывается gdk_drop_finish(), чтобы сообщить источнику о завершении переноса. Вызов gdk_drop_finish() должен выполняться только после получения всех данных.

Для получения данных используйте одну из функций чтения, предоставляемых объектом GdkDrop, например, gdk_drop_read_async() или gdk_drop_read_value_async().

Флаги: Run Last