Перетаскивание

gtk_drag_dest_set ()

void
gtk_drag_dest_set (GtkWidget *widget,
                   GtkDestDefaults flags,
                   const GtkTargetEntry *targets,
                   gint n_targets,
                   GdkDragAction actions);

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

Стандартное поведение, перечисленное в flags, имеет эффект, аналогичный установке обработчиков по умолчанию для сигналов перетаскивания и сброса виджета (“drag-motion”, “drag-drop”, ...). Они все существуют для удобства. Например, при передаче GTK_DEST_DEFAULT_ALL достаточно подключиться к сигналу “drag-data-received” виджета, чтобы получить простую, но согласованную поддержку перетаскивания и сброса.

Все усложняется, когда вы пытаетесь предварительно просмотреть перетаскиваемые данные, как описано в документации для “drag-motion”. Стандартное поведение, описанное в flags, делает некоторые предположения, которые могут конфликтовать с вашими собственными обработчиками сигналов. Например, GTK_DEST_DEFAULT_DROP вызывает вызовы gdk_drag_status() в контексте “drag-motion” и вызовы gtk_drag_finish() в “drag-data-received”. Особенно последнее драматично, когда ваш собственный обработчик “drag-motion” вызывает gtk_drag_get_data() для проверки перетаскиваемых данных.

Нет способа установить действие по умолчанию здесь, вы можете использовать обратный вызов “drag-motion” для этого. Вот пример, который выбирает используемое действие в зависимости от того, нажата ли клавиша управления:

static void
drag_motion (GtkWidget *widget,
             GdkDragContext *context,
             gint x,
             gint y,
             guint time)
{
  GdkModifierType mask;

  gdk_window_get_pointer (gtk_widget_get_window (widget),
                          NULL, NULL, &mask);
  if (mask & GDK_CONTROL_MASK)
    gdk_drag_status (context, GDK_ACTION_COPY, time);
  else
    gdk_drag_status (context, GDK_ACTION_MOVE, time);
}

[метод]

gtk_drag_dest_set_proxy ()

void
gtk_drag_dest_set_proxy (GtkWidget *widget,
                         GdkWindow *proxy_window,
                         GdkDragProtocol protocol,
                         gboolean use_coordinates);

Устанавливает этот виджет в качестве прокси для сброса в другое окно.

[метод]

gtk_drag_dest_unset ()

void
gtk_drag_dest_unset (GtkWidget *widget);

Очищает информацию о пункте назначения сброса, установленную с помощью gtk_drag_dest_set(). Виджет больше не будет получать уведомления о перетаскивании.

[метод]

gtk_drag_dest_find_target ()

GdkAtom
gtk_drag_dest_find_target (GtkWidget *widget,
                           GdkDragContext *context,
                           GtkTargetList *target_list);

Ищет совпадение между поддерживаемыми целевыми объектами context и dest_target_list, возвращая первую соответствующую цель, в противном случае возвращая GDK_NONE. dest_target_list обычно должно быть значением, возвращаемым из gtk_drag_dest_get_target_list(), но некоторые виджеты могут иметь разные допустимые цели для разных частей виджета; в этом случае им необходимо реализовать обработчик drag_motion, передающий правильный список целей в эту функцию.

[метод]

gtk_drag_dest_get_target_list ()

GtkTargetList *
gtk_drag_dest_get_target_list (GtkWidget *widget);

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

[метод]

gtk_drag_dest_set_target_list ()

void
gtk_drag_dest_set_target_list (GtkWidget *widget,
                               GtkTargetList *target_list);

Устанавливает типы целевых данных, которые этот виджет может принять при перетаскивании. Сначала виджет должен быть настроен как целевой для перетаскивания с помощью gtk_drag_dest_set().

[метод]

gtk_drag_dest_add_text_targets ()

void
gtk_drag_dest_add_text_targets (GtkWidget *widget);

Добавляет целевые типы данных текста, поддерживаемые GtkSelectionData, в список целевых данных для перетаскивания. Целевые типы добавляются со значением info = 0. Если необходимо другое значение, используйте gtk_target_list_add_text_targets() и gtk_drag_dest_set_target_list().

[метод]

С: 2.6

gtk_drag_dest_add_image_targets ()

void
gtk_drag_dest_add_image_targets (GtkWidget *widget);

Добавляет целевые типы данных изображений, поддерживаемые GtkSelectionData, в список целевых данных для перетаскивания. Целевые типы добавляются со значением info = 0. Если необходимо другое значение, используйте gtk_target_list_add_image_targets() и gtk_drag_dest_set_target_list().

[метод]

С: 2.6

gtk_drag_dest_add_uri_targets ()

void
gtk_drag_dest_add_uri_targets (GtkWidget *widget);

Добавляет целевые типы данных URI, поддерживаемые GtkSelectionData, в список целевых данных для перетаскивания. Целевые типы добавляются со значением info = 0. Если необходимо другое значение, используйте gtk_target_list_add_uri_targets() и gtk_drag_dest_set_target_list().

[метод]

С: 2.6

gtk_drag_dest_set_track_motion ()

void
gtk_drag_dest_set_track_motion (GtkWidget *widget,
                                gboolean track_motion);

Указывает виджету генерировать события “drag-motion” и “drag-leave”, независимо от целевых данных и флага GTK_DEST_DEFAULT_MOTION.

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

[метод]

С: 2.10

gtk_drag_dest_get_track_motion ()

gboolean
gtk_drag_dest_get_track_motion (GtkWidget *widget);

Возвращает значение, определяющее, настроен ли виджет на всегда генерирование сигналов “drag-motion”.

[метод]

С: 2.10

gtk_drag_finish ()

void
gtk_drag_finish (GdkDragContext *context,
                 gboolean success,
                 gboolean del,
                 guint32 time_);

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

[метод]

gtk_drag_get_data ()

void
gtk_drag_get_data (GtkWidget *widget,
                   GdkDragContext *context,
                   GdkAtom target,
                   guint32 time_);

Получает данные, связанные с перетаскиванием. Когда данные получены или их получение не удалось, GTK+ генерирует сигнал “drag-data-received”. Неудачное получение данных указывается отрицательным значением длины в параметре selection_data сигнала. Однако, когда gtk_drag_get_data() вызывается неявно из-за установки флага GTK_DEST_DEFAULT_DROP, виджет не получает уведомления об ошибках получения данных.

[метод]

gtk_drag_get_source_widget ()

GtkWidget *
gtk_drag_get_source_widget (GdkDragContext *context);

Определяет виджет-источник для перетаскивания.

[метод]

gtk_drag_highlight ()

void
gtk_drag_highlight (GtkWidget *widget);

Подсвечивает виджет как текущую целевую область для опускания. Для отмены подсвечивания вызовите gtk_drag_unhighlight(). GTK+ автоматически вызывает эту функцию, если установлен GTK_DEST_DEFAULT_HIGHLIGHT.

[метод]

gtk_drag_unhighlight ()

void
gtk_drag_unhighlight (GtkWidget *widget);

Удаляет подсвечивание, установленное функцией gtk_drag_highlight(), с виджета.

[метод]

gtk_drag_begin ()

GdkDragContext *
gtk_drag_begin (GtkWidget *widget,
                GtkTargetList *targets,
                GdkDragAction actions,
                gint button,
                GdkEvent *event);

Эта функция эквивалентна gtk_drag_begin_with_coordinates() с координатами -1, -1.

[метод]

gtk_drag_begin_with_coordinates ()

GdkDragContext *
gtk_drag_begin_with_coordinates (GtkWidget *widget,
                                 GtkTargetList *targets,
                                 GdkDragAction actions,
                                 gint button,
                                 GdkEvent *event,
                                 gint x,
                                 gint y);

Инициализирует перетаскивание со стороны источника. Функция нужна только при ручном запуске перетаскивания приложением, если используется gtk_drag_source_set().

Параметр event используется для получения отметки времени, используемой внутри для захвата указателя. Если event имеет значение NULL, то используется GDK_CURRENT_TIME. Однако, в любом случае рекомендуется передавать реальное событие, так как оно может содержать информацию о перетаскивании.

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

[метод]

С: 3.10

gtk_drag_cancel ()

void
gtk_drag_cancel (GdkDragContext *context);

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

Чтобы иметь возможность отменить операцию перетаскивания таким образом, вам нужно сохранить указатель на контекст перетаскивания, либо из явного вызова gtk_drag_begin_with_coordinates(), либо подключившись к “drag-begin”.

Если context не ссылается на текущую операцию перетаскивания, эта функция ничего не делает.

Если перетаскивание отменено таким образом, аргумент result сигнала “drag-failed” устанавливается в значение GTK_DRAG_RESULT_ERROR .

[метод]

С: 3.16

gtk_drag_set_icon_widget ()

void
gtk_drag_set_icon_widget (GdkDragContext *context,
                          GtkWidget *widget,
                          gint hot_x,
                          gint hot_y);

Изменяет значок операции перетаскивания на заданный виджет. GTK+ не уничтожит виджет, поэтому если вы не хотите, чтобы он сохранялся, подключитесь к сигналу «drag-end» и уничтожьте его самостоятельно.

[метод]

gtk_drag_set_icon_pixbuf ()

void
gtk_drag_set_icon_pixbuf (GdkDragContext *context,
                          GdkPixbuf *pixbuf,
                          gint hot_x,
                          gint hot_y);

Устанавливает pixbuf в качестве значка для данного перетаскивания.

gtk_drag_set_icon_stock ()

void
gtk_drag_set_icon_stock (GdkDragContext *context,
                         const gchar *stock_id,
                         gint hot_x,
                         gint hot_y);

Устанавливает значок для данного перетаскивания по идентификатору из набора значков.

gtk_drag_set_icon_surface ()

void
gtk_drag_set_icon_surface (GdkDragContext *context,
                           cairo_surface_t *surface);

Устанавливает surface в качестве значка для данного перетаскивания. GTK+ сохраняет ссылки на аргументы и освобождает их, когда они больше не нужны.

Чтобы расположить поверхность относительно курсора мыши, используйте cairo_surface_set_device_offset() на surface . Курсор мыши будет расположен в координатах (0,0) поверхности.

gtk_drag_set_icon_name ()

void
gtk_drag_set_icon_name (GdkDragContext *context,
                        const gchar *icon_name,
                        gint hot_x,
                        gint hot_y);

Устанавливает значок для данного перетаскивания по имени значка из темы. Подробнее см. в документации к GtkIconTheme. Обратите внимание, что размер значка зависит от темы значков (значок загружается с символическим размером GTK_ICON_SIZE_DND), поэтому hot_x и hot_y следует использовать с осторожностью.

С: 2.8

gtk_drag_set_icon_gicon ()

void
gtk_drag_set_icon_gicon (GdkDragContext *context,
                         GIcon *icon,
                         gint hot_x,
                         gint hot_y);

Устанавливает значок для данного перетаскивания по заданному icon. Подробнее о работе со значками при перетаскивании см. документацию к gtk_drag_set_icon_name().

С: 3.2

gtk_drag_set_icon_default ()

void
gtk_drag_set_icon_default (GdkDragContext *context);

Устанавливает значок для данного перетаскивания по умолчанию.

[метод]

gtk_drag_check_threshold ()

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

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

[метод]

gtk_drag_source_set ()

void
gtk_drag_source_set (GtkWidget *widget,
                     GdkModifierType start_button_mask,
                     const GtkTargetEntry *targets,
                     gint n_targets,
                     GdkDragAction actions);

Настраивает виджет так, чтобы GTK+ инициировал операцию перетаскивания, когда пользователь нажимает и перетаскивает этот виджет. Виджет должен иметь окно.

[метод]

gtk_drag_source_set_icon_pixbuf ()

void
gtk_drag_source_set_icon_pixbuf (GtkWidget *widget,
                                 GdkPixbuf *pixbuf);

Устанавливает значок, который будет использоваться для перетаскивания с конкретного виджета из GdkPixbuf. GTK+ сохраняет ссылку на pixbuf и освободит её, когда она больше не потребуется.

[метод]

gtk_drag_source_set_icon_stock ()

void
gtk_drag_source_set_icon_stock (GtkWidget *widget,
                                const gchar *stock_id);

Устанавливает значок, который будет использоваться для перетаскивания с определённого источника, как стандартный значок.

[метод]

gtk_drag_source_set_icon_name ()

void
gtk_drag_source_set_icon_name (GtkWidget *widget,
                               const gchar *icon_name);

Устанавливает значок, который будет использоваться для перетаскивания с определённого источника, как тематический значок. Подробнее см. документацию для GtkIconTheme.

[метод]

С: 2.8

gtk_drag_source_set_icon_gicon ()

void
gtk_drag_source_set_icon_gicon (GtkWidget *widget,
                                GIcon *icon);

Устанавливает значок, который будет использоваться для перетаскивания с определённого источника, как icon. Подробнее см. документацию для GtkIconTheme.

[метод]

С: 3.2

gtk_drag_source_unset ()

void
gtk_drag_source_unset (GtkWidget *widget);

Отменяет действия, заданные с помощью gtk_drag_source_set().

[метод]

gtk_drag_source_set_target_list ()

void
gtk_drag_source_set_target_list (GtkWidget *widget,
                                 GtkTargetList *target_list);

Изменяет типы целевых объектов, предлагаемых этим виджетом для перетаскивания. Виджет должен быть сначала настроен как источник перетаскивания с помощью gtk_drag_source_set().

[метод]

С: 2.4

gtk_drag_source_get_target_list ()

GtkTargetList *
gtk_drag_source_get_target_list (GtkWidget *widget);

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

[метод]

С: 2.4

gtk_drag_source_add_text_targets ()

void
gtk_drag_source_add_text_targets (GtkWidget *widget);

Добавьте поддерживаемые текстовые целевые объекты GtkSelectionData в список целевых объектов источника перетаскивания. Целевые объекты добавляются со значением info = 0. Если вам нужно другое значение, используйте gtk_target_list_add_text_targets() и gtk_drag_source_set_target_list().

[метод]

С: 2.6

gtk_drag_source_add_image_targets ()

void
gtk_drag_source_add_image_targets (GtkWidget *widget);

Добавьте поддерживаемые целевые объекты для изображений для записи GtkSelectionData в список целевых объектов источника перетаскивания. Целевые объекты добавляются со значением info = 0. Если вам нужно другое значение, используйте gtk_target_list_add_image_targets() и gtk_drag_source_set_target_list().

[метод]

С: 2.6

gtk_drag_source_add_uri_targets ()

void
gtk_drag_source_add_uri_targets (GtkWidget *widget);

Добавьте поддерживаемые целевые объекты URI GtkSelectionData в список целевых объектов источника перетаскивания. Целевые объекты добавляются со значением info = 0. Если вам нужно другое значение, используйте gtk_target_list_add_uri_targets() и gtk_drag_source_set_target_list().

[метод]

С: 2.6