GtkDropTarget

gtk_drop_target_new ()

GtkDropTarget *
gtk_drop_target_new (GType type,
                     GdkDragAction actions);

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

Если целевой объект перетаскивания должен поддерживать более 1 типа, передайте G_TYPE_INVALID для type, а затем вызовите gtk_drop_target_set_gtypes().

gtk_drop_target_set_gtypes ()

void
gtk_drop_target_set_gtypes (GtkDropTarget *self,
                            GType *types,
                            gsize n_types);

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

gtk_drop_target_get_gtypes ()

const GType *
gtk_drop_target_get_gtypes (GtkDropTarget *self,
                            gsize *n_types);

Получает список поддерживаемых GTypes для self . Если ни один тип не был задан, будет возвращено NULL.

gtk_drop_target_get_formats ()

GdkContentFormats *
gtk_drop_target_get_formats (GtkDropTarget *self);

Получает форматы данных, которые принимает эта цель перетаскивания.

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

gtk_drop_target_set_actions ()

void
gtk_drop_target_set_actions (GtkDropTarget *self,
                             GdkDragAction actions);

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

gtk_drop_target_get_actions ()

GdkDragAction
gtk_drop_target_get_actions (GtkDropTarget *self);

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

gtk_drop_target_set_preload ()

void
gtk_drop_target_set_preload (GtkDropTarget *self,
                             gboolean preload);

Устанавливает свойство GtkDropTarget:preload.

gtk_drop_target_get_preload ()

gboolean
gtk_drop_target_get_preload (GtkDropTarget *self);

Получает значение свойства GtkDropTarget:preload.

gtk_drop_target_get_drop ()

GdkDrop *
gtk_drop_target_get_drop (GtkDropTarget *self);

Получает текущую обрабатываемую операцию перетаскивания.

Если операция перетаскивания не выполняется, возвращается NULL.

gtk_drop_target_get_value ()

const GValue *
gtk_drop_target_get_value (GtkDropTarget *self);

Получает значение свойства GtkDropTarget:value.

gtk_drop_target_reject ()

void
gtk_drop_target_reject (GtkDropTarget *self);

Отклоняет текущую операцию перетаскивания.

Если операция перетаскивания не выполняется - когда GdkDropTarget:drop возвращает NULL, - эта функция ничего не делает.

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

GtkDropTarget

typedef struct _GtkDropTarget GtkDropTarget;

Свойство “actions”

  “actions”                  GdkDragAction

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

Владелец: GtkDropTarget

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

Свойство “drop”

  “drop”                     GdkDrop *

Текущая операция GdkDrop.

Владелец: GtkDropTarget

Флаги: Чтение

Свойство “formats”

  “formats”                  GdkContentFormats *

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

Владелец: GtkDropTarget

Флаги: Чтение

Свойство “preload”

  “preload”                  gboolean

Загружать ли данные при наведении курсора на виджет, но до его отпуска.

Настройка этого свойства позволяет более тонко реагировать на операцию переноса, но потребует больше данных.

По умолчанию это свойство установлено в FALSE, чтобы избежать случайной загрузки больших объёмов данных. Например, если пользователь перетаскивает весь документ размером в гигабайты из текстового редактора на виджет с предварительной загрузкой, эти данные будут загружены, даже если данные в конечном итоге будут переброшены в другое место.

Для многих форматов данных объём данных невелик (например, GDK_TYPE_RGBA), поэтому включение этого свойства не повлияет на производительность. При локальных операциях drag-and-drop вообще не происходит передачи данных, поэтому его включение не затратно.

Владелец: GtkDropTarget

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

Значение по умолчанию: FALSE

Свойство “value”

  “value”                    GValue *

Значение для этой операции переноса или NULL, если данные ещё не загружены или операция переноса не выполняется.

Данные могут быть доступны до вызова сигнала “drop” — например, когда свойство “preload” установлено. Вы можете использовать сигнал “notify” для получения уведомления о доступных данных.

Владелец: GtkDropTarget

Флаги: Чтение

Сигнал “accept”

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

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

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

Если решение о принятии или отклонении переноса зависит от данных, эта функция должна возвращать TRUE, свойство “preload” должно быть установлено, и значение должно быть проверено через сигнал “value”, вызывая gtk_drop_target_reject() при необходимости.

Флаги: Выполняется последним

Сигнал “drop”

gboolean
user_function (GtkDropTarget *self,
               GValue        *value,
               double         x,
               double         y,
               gpointer       user_data)

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

В противном случае обработчик возвращает TRUE. В этом случае обработчик примет перенос. Обработчик отвечает за чтение переданных value и выполнение операции переноса.

Флаги: Выполняется последним

Сигнал “enter”

GdkDragAction
user_function (GtkDropTarget *self,
               double         x,
               double         y,
               gpointer       user_data)

Сигнал ::enter генерируется на целевом объекте, когда курсор входит в виджет. Он может использоваться для настройки пользовательской подсветки.

Флаги: Выполняется последним

Сигнал “leave”

void
user_function (GtkDropTarget *self,
               gpointer       user_data)

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

Флаги: Выполняется последним

Сигнал “motion”

GdkDragAction
user_function (GtkDropTarget *self,
               double         x,
               double         y,
               gpointer       user_data)

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

Флаги: Выполняется последним