GtkDragSource

gtk_drag_source_new ()

GtkDragSource *
gtk_drag_source_new (void);

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

gtk_drag_source_set_content ()

void
gtk_drag_source_set_content (GtkDragSource *source,
                             GdkContentProvider *content);

Устанавливает поставщик содержимого для объекта GtkDragSource.

При запросе данных в ходе операции перетаскивания данные будут получены от поставщика содержимого.

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

Можно рассмотреть установку поставщика содержимого обратно в значение NULL в обработчике сигнала “drag-end”.

gtk_drag_source_get_content ()

GdkContentProvider *
gtk_drag_source_get_content (GtkDragSource *source);

Возвращает текущего поставщика содержимого объекта GtkDragSource.

gtk_drag_source_set_actions ()

void
gtk_drag_source_set_actions (GtkDragSource *source,
                             GdkDragAction actions);

Устанавливает действия для объекта GtkDragSource.

Во время операции перетаскивания действия предлагаются потенциальным целевым объектам. Если actions включают GDK_ACTION_MOVE, необходимо прослушивать сигнал “drag-end” и обрабатывать delete_data как TRUE.

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

gtk_drag_source_get_actions ()

GdkDragAction
gtk_drag_source_get_actions (GtkDragSource *source);

Получает действия, установленные для объекта GtkDragSource.

gtk_drag_source_set_icon ()

void
gtk_drag_source_set_icon (GtkDragSource *source,
                          GdkPaintable *paintable,
                          int hot_x,
                          int hot_y);

Устанавливает элемент отрисовки для использования в качестве значка во время операции перетаскивания.

Координаты точки привязки определяют точку на значке, которая выравнивается с точкой привязки курсора.

Если paintable равно NULL, используется значок по умолчанию.

Эта функция может быть вызвана до начала перетаскивания, или в обработчике сигналов “prepare” или “drag-begin”.

gtk_drag_source_drag_cancel ()

void
gtk_drag_source_drag_cancel (GtkDragSource *source);

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

gtk_drag_source_get_drag ()

GdkDrag *
gtk_drag_source_get_drag (GtkDragSource *source);

Возвращает базовый объект GdkDrag для текущей операции перетаскивания.

gtk_drag_check_threshold ()

gboolean
gtk_drag_check_threshold (GtkWidget *widget,
                          int start_x,
                          int start_y,
                          int current_x,
                          int current_y);

Проверяет, прошла ли операция перетаскивания порог GTK, начавшаяся в точке (start_x , start_y ) и завершившаяся в точке (current_x , current_y ), и, следовательно, должна ли начаться операция перетаскивания и перекладывания.

[method]

GtkDragSource

typedef struct _GtkDragSource GtkDragSource;

Свойство “actions”

  “actions”                  GdkDragAction

Действия, поддерживаемые операциями перетаскивания из источника.

Обратите внимание, что вам необходимо обработать сигнал “drag-end”, если действия включают GDK_ACTION_MOVE.

Владелец: GtkDragSource

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

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

Свойство “content”

  “content”                  GdkContentProvider *

Данные, предлагаемые операциями перетаскивания из этого источника в виде GdkContentProvider.

Владелец: GtkDragSource

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

Сигнал “drag-begin”

void
user_function (GtkDragSource *source,
               GdkDrag       *drag,
               gpointer       user_data)

Сигнал ::drag-begin испускается в источнике перетаскивания при начале перетаскивания. Он может быть использован для, например, установки пользовательского значка перетаскивания с помощью gtk_drag_source_set_icon().

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

Сигнал “drag-cancel”

gboolean
user_function (GtkDragSource      *source,
               GdkDrag            *drag,
               GdkDragCancelReason reason,
               gpointer            user_data)

Сигнал ::drag-cancel испускается в источнике перетаскивания, когда перетаскивание завершилось неудачно. Обработчик сигнала может обработать неудачную операцию перетаскивания в зависимости от типа ошибки. Он должен вернуть TRUE если ошибка обработана, и анимация по умолчанию «операция перетаскивания завершилась неудачно» не должна отображаться.

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

Сигнал “drag-end”

void
user_function (GtkDragSource *source,
               GdkDrag       *drag,
               gboolean       delete_data,
               gpointer       user_data)

Сигнал ::drag-end испускается в источнике перетаскивания по завершении перетаскивания. Типичная причина подключения к этому сигналу — отмена действий, выполненных в “prepare” или “drag-begin”.

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

Сигнал “prepare”

GdkContentProvider*
user_function (GtkDragSource *source,
               double         x,
               double         y,
               gpointer       user_data)

Сигнал ::prepare испускается, когда операция перетаскивания собирается инициировать. Он возвращает * GdkContentProvider для использования при перетаскивании, которое собирается начать. Обработчик по умолчанию для этого сигнала возвращает значение свойства “content”, поэтому если вы настроили это свойство заранее, вам не нужно подключаться к этому сигналу.

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