краткое описание

#include <gtk/gtk.h>


            gtktreedragsource;
            gtktreedragsourceiface;

gboolean    gtk_tree_drag_source_drag_data_delete
                                            (gtktreedragsource *drag_source,
                                             gtktreepath *path);
gboolean    gtk_tree_drag_source_drag_data_get
                                            (gtktreedragsource *drag_source,
                                             gtktreepath *path,
                                             gtkselectiondata *selection_data);

gboolean    gtk_tree_drag_source_row_draggable
                                            (gtktreedragsource *drag_source,
                                             gtktreepath *path);
            gtktreedragdest;
            gtktreedragdestiface;
gboolean    gtk_tree_drag_dest_drag_data_received

                                            (gtktreedragdest *drag_dest,
                                             gtktreepath *dest,
                                             gtkselectiondata *selection_data);
gboolean    gtk_tree_drag_dest_row_drop_possible
                                            (gtktreedragdest *drag_dest,
                                             gtktreepath *dest_path,
                                             gtkselectiondata *selection_data);

gboolean    gtk_tree_set_row_drag_data      (gtkselectiondata *selection_data,
                                             gtktreemodel *tree_model,
                                             gtktreepath *path);
gboolean    gtk_tree_get_row_drag_data      (gtkselectiondata *selection_data,
                                             gtktreemodel **tree_model,
                                             gtktreepath **path);

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

  ginterface
   +----gtktreedragsource

  ginterface
   +----gtktreedragdest

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

gtktreedragsource реализован gtktreemodelsort, gtktreestore, gtkliststore и gtktreemodelfilter.

gtktreedragdest реализован gtktreestore и gtkliststore.

описание

gtk+ поддерживает drag-and-drop в деревьях просмотра с помощью низкоуровневых и высокоуровневых api.

api низкого уровня содержит gtk+ dnd api, расширенный некоторыми сервисными функциями 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 представляет большую гибкость, но ничего не выполняет автоматически, а осуществление расширенных особенностей, таких как открытие строк при наведении (hover-to-open-rows) или автоматическое прокручивание выше уровня работы этого api.

с другой стороны, если вы создаёте высокоуровневый api, то весь обсчет строк выполняется за вас, так же как открытие при наведении (hover-to-open) и автоматическое прокручивание (auto-scroll), но ваши модели должны реализовывать интерфейсы gtktreedragsource и gtktreedragdest.

детали

gtktreedragsource

typedef struct _gtktreedragsource gtktreedragsource;

gtktreedragsourceiface

typedef struct {
  gtypeinterface g_iface;

  /* 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);
} gtktreedragsourceiface;

gtk_tree_drag_source_drag_data_delete ()

gboolean    gtk_tree_drag_source_drag_data_delete
                                            (gtktreedragsource *drag_source,
                                             gtktreepath *path);

запрашивает gtktreedragsource для удаления строки из path, потому что она была перемещена куда либо посредством операции drag-and-drop. возвращает false если удаление не удалось потому что path больше не существует, или по некоторым специфичным причинам модели. должна надёжно обрабатывать path не находящийся больше в модели!

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 не находящийся больше в модели!

gtk_tree_drag_source_row_draggable ()

gboolean    gtk_tree_drag_source_row_draggable
                                            (gtktreedragsource *drag_source,
                                             gtktreepath *path);

запрашивает gtktreedragsource может ли определенная строка быть источником dnd операции. если источник не реализует этот интерфейс, строка это предполагаемый объект перемещения.

gtktreedragdest

typedef struct _gtktreedragdest gtktreedragdest;

gtktreedragdestiface

typedef struct {
  gtypeinterface g_iface;

  /* 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);
} gtktreedragdestiface;

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 происходит из того же процесса который вызвал эту функцию, потому что указатель на дерево модели помещается рядом. если вы не находитесь в том же самом процессе, то вы получите искажение памяти. в gtktreedragdest drag_data_received обработчике, вы можете предположить что выделенные данные типа gtk_tree_model_row находятся в текущемм процессе. возвращаемый путь должен освобождаться с помощью gtk_tree_path_free().