GtkTreeView перетаскивание

GtkTreeView перетаскивание — Интерфейсы для поддержки перетаскивания в GtkTreeView

Функции

gboolean	gtk_tree_drag_source_drag_data_delete ()
gboolean	gtk_tree_drag_source_drag_data_get ()
gboolean	gtk_tree_drag_source_row_draggable ()
gboolean	gtk_tree_drag_dest_drag_data_received ()
gboolean	gtk_tree_drag_dest_row_drop_possible ()
gboolean	gtk_tree_set_row_drag_data ()
gboolean	gtk_tree_get_row_drag_data ()

Типы и значения

	GtkTreeDragSource
struct	GtkTreeDragSourceIface
	GtkTreeDragDest
struct	GtkTreeDragDestIface

Иерархия объектов

    GInterface
    ├── GtkTreeDragDest
    ╰── GtkTreeDragSource

Известные реализации

GtkTreeDragSource реализован в GtkListStore, GtkTreeModelFilter, GtkTreeModelSort и GtkTreeStore.

GtkTreeDragDest реализован в GtkListStore и GtkTreeStore.

Файлы заголовков

#include <gtk/gtk.h>

Описание

GTK+ поддерживает перетаскивание в дереве представлений с помощью API высокого и низкого уровня.

API низкого уровня состоит из API перетаскивания GTK+, дополненного некоторыми вспомогательными функциями treeview: gtk_tree_view_set_drag_dest_row(), gtk_tree_view_get_drag_dest_row(), gtk_tree_view_get_dest_row_at_pos(), gtk_tree_view_create_row_drag_icon(), gtk_tree_set_row_drag_data() и gtk_tree_get_row_drag_data(). Этот API предоставляет большую гибкость, но ничего не делается автоматически, а реализация расширенных функций, таких как открытие строк при наведении или автоматическое прокручивание на основе этого API, требует значительных усилий.

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

Функции

gtk_tree_drag_source_drag_data_delete ()

gboolean
gtk_tree_drag_source_drag_data_delete (GtkTreeDragSource *drag_source,
                                       GtkTreePath *path);

Просит GtkTreeDragSource удалить строку по пути path, так как она была перемещена в другое место с помощью перетаскивания. Возвращает FALSE, если удаление не удалось, потому что path больше не существует или по какой-то причине, связанной с моделью. Должен надёжно обрабатывать случай, когда path больше не найдено в модели!

Параметры

drag_source	объект GtkTreeDragSource
path	строка, которая перетаскивалась

Возвращаемое значение

TRUE, если строка была успешно удалена

gtk_tree_drag_source_drag_data_get ()

gboolean
gtk_tree_drag_source_drag_data_get (GtkTreeDragSource *drag_source,
                                    GtkTreePath *path,
                                    GtkSelectionData *selection_data);

Просит GtkTreeDragSource заполнить selection_data представлением строки по пути path. selection_data->target задаёт требуемый тип данных. Должен надёжно обрабатывать случай, когда path больше не найдено в модели!

Параметры

drag_source	объект GtkTreeDragSource
path	строка, которая перетаскивалась
selection_data	объект GtkSelectionData для заполнения данными из перетаскиваемой строки

Возвращаемое значение

TRUE, если данные требуемого типа были предоставлены

gtk_tree_drag_source_row_draggable ()

gboolean
gtk_tree_drag_source_row_draggable (GtkTreeDragSource *drag_source,
                                    GtkTreePath *path);

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

Параметры

drag_source	объект GtkTreeDragSource
path	строка, с которой пользователь начал перетаскивание

Возвращаемое значение

TRUE, если строку можно перетащить

gtk_tree_drag_dest_drag_data_received ()

gboolean
gtk_tree_drag_dest_drag_data_received (GtkTreeDragDest *drag_dest,
                                       GtkTreePath *dest,
                                       GtkSelectionData *selection_data);

Просит GtkTreeDragDest вставить строку перед путем dest, используя содержимое из selection_data. Если dest находится вне дерева так, что вставка перед ним невозможна, будет возвращено FALSE. Также FALSE может быть возвращено, если новая строка не создаётся по какой-то причине, связанной с моделью. Должен надёжно обрабатывать случай, когда dest больше не найдено в модели!

...

gtk_tree_drag_dest_row_drop_possible ()

gboolean
gtk_tree_drag_dest_row_drop_possible (GtkTreeDragDest *drag_dest,
                                      GtkTreePath *dest_path,
                                      GtkSelectionData *selection_data);

Определяет, возможно ли переместить данные перед заданной dest_path, на том же уровне, что и dest_path. То есть, можем ли мы переместить данные в selection_data в этом месте. dest_path не обязательно должна существовать; возвратное значение практически гарантированно будет FALSE, если родитель dest_path не существует.

...

gtk_tree_set_row_drag_data ()

gboolean
gtk_tree_set_row_drag_data (GtkSelectionData *selection_data,
                            GtkTreeModel *tree_model,
                            GtkTreePath *path);

Устанавливает данные выбора типа GTK_TREE_MODEL_ROW. Обычно используется в обработчике drag_data_get.

...

gtk_tree_get_row_drag_data ()

gboolean
gtk_tree_get_row_drag_data (GtkSelectionData *selection_data,
                            GtkTreeModel **tree_model,
                            GtkTreePath **path);

Получает tree_model и path из данных выбора целевого типа GTK_TREE_MODEL_ROW. Обычно вызывается из обработчика drag_data_received. Эта функция может быть использована только в том случае, если selection_data происходит от того же процесса, что и вызов этой функции, так как указатель на модель дерева передаётся. Если вы не в том же процессе, то произойдёт ошибка памяти. В обработчике drag_data_received GtkTreeDragDest, вы можете предположить, что данные выбора типа GTK_TREE_MODEL_ROW поступают из текущего процесса. Возвращаемый путь необходимо освободить с помощью gtk_tree_path_free().

Параметры

selection_data	данные GtkSelectionData
tree_model	GtkTreeModel.	[nullable][optional][transfer none][out]
path	строка в `tree_model` .	[nullable][optional][out]

Возвращаемое значение

TRUE, если у selection_data был целевой тип GTK_TREE_MODEL_ROW и в противном случае является корректным

Типы и значения

GtkTreeDragSource

typedef struct _GtkTreeDragSource GtkTreeDragSource;

struct GtkTreeDragSourceIface

struct GtkTreeDragSourceIface {
  /* VTable - not signals */

  gboolean     (* row_draggable)        (GtkTreeDragSource   *drag_source,
                                         GtkTreePath         *path);

  gboolean     (* drag_data_get)        (GtkTreeDragSource   *drag_source,
                                         GtkTreePath         *path,
                                         GtkSelectionData    *selection_data);

  gboolean     (* drag_data_delete)     (GtkTreeDragSource *drag_source,
                                         GtkTreePath       *path);
};

Члены

`row_draggable` ()	Запрашивает у GtkTreeDragSource, можно ли использовать определённую строку в качестве источника операции DND.
`drag_data_get` ()	Запрашивает у GtkTreeDragSource заполнить selection_data представлением строки в пути.
`drag_data_delete` ()	Запрашивает у GtkTreeDragSource удалить строку в пути, так как она была перемещена в другое место через перетаскивание.

GtkTreeDragDest

typedef struct _GtkTreeDragDest GtkTreeDragDest;

struct GtkTreeDragDestIface

struct GtkTreeDragDestIface {
  /* VTable - not signals */

  gboolean     (* drag_data_received) (GtkTreeDragDest   *drag_dest,
                                       GtkTreePath       *dest,
                                       GtkSelectionData  *selection_data);

  gboolean     (* row_drop_possible)  (GtkTreeDragDest   *drag_dest,
                                       GtkTreePath       *dest_path,
				       GtkSelectionData  *selection_data);
};

Члены

`drag_data_received` ()	Запрашивает у GtkTreeDragDest вставить строку перед путем dest, получив содержимое строки из selection_data.
`row_drop_possible` ()	Определяет, возможно ли поместить объект в указанный путь dest, на той же глубине, что и dest_path.

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.22/gtk3-GtkTreeView-drag-and-drop.html