GtkTreeView

GtkTreeViewColumnDropFunc ()

gboolean
(*GtkTreeViewColumnDropFunc) (GtkTreeView *tree_view,
                              GtkTreeViewColumn *column,
                              GtkTreeViewColumn *prev_column,
                              GtkTreeViewColumn *next_column,
                              gpointer data);

Тип функции для определения, можно ли column переместить в определённое место (определяемое prev_column и next_column ). В локалях слева направо, prev_column находится слева от потенциального места перетаскивания, а next_column — справа. В режиме справа налево это меняется. Эта функция должна возвращать TRUE , если место является допустимым местом перетаскивания. Обратите внимание, что возврат TRUE не означает, что перетаскивание столбца выполнено, а только указывает пользователю на возможное место перетаскивания.

GtkTreeViewMappingFunc ()

void
(*GtkTreeViewMappingFunc) (GtkTreeView *tree_view,
                           GtkTreePath *path,
                           gpointer user_data);

Функция, используемая для gtk_tree_view_map_expanded_rows().

GtkTreeViewSearchEqualFunc ()

gboolean
(*GtkTreeViewSearchEqualFunc) (GtkTreeModel *model,
                               int column,
                               const char *key,
                               GtkTreeIter *iter,
                               gpointer search_data);

Функция для проверки, соответствует ли строка в model строке поиска, введённой пользователем. Обратите внимание, что возвращаемое значение инвертировано по сравнению с ожидаемым, хотя оно имеет некоторое сходство с strcmp() , возвращающим 0 для равных строк.

gtk_tree_view_new ()

GtkWidget *
gtk_tree_view_new (void);

Создаёт новый виджет GtkTreeView.

gtk_tree_view_get_level_indentation ()

int
gtk_tree_view_get_level_indentation (GtkTreeView *tree_view);

Возвращает величину, в пикселях, дополнительного отступа для дочерних уровней в tree_view .

gtk_tree_view_get_show_expanders ()

gboolean
gtk_tree_view_get_show_expanders (GtkTreeView *tree_view);

Возвращает, отображаются ли раскрывающие значки в tree_view .

gtk_tree_view_set_level_indentation ()

void
gtk_tree_view_set_level_indentation (GtkTreeView *tree_view,
                                     int indentation);

Устанавливает величину дополнительного отступа для дочерних уровней для использования в tree_view в дополнение к стандартному отступу. Значение должно быть указано в пикселях; значение 0 отключает эту функцию и используется только стандартный отступ. Для списков это не имеет видимого эффекта.

gtk_tree_view_set_show_expanders ()

void
gtk_tree_view_set_show_expanders (GtkTreeView *tree_view,
                                  gboolean enabled);

Устанавливает, отображать и активировать раскрывающие значки и отступ дочерних строк в tree_view. При отключении значки раскрытия не будут отображаться в деревьях, и по умолчанию не будет возможности раскрывать и сворачивать строки. Обратите также внимание, что скрытие раскрывающих значков отключит стандартный отступ. В этом случае вы можете установить настраиваемый отступ с помощью gtk_tree_view_set_level_indentation(). Для списков это не имеет видимого эффекта.

gtk_tree_view_new_with_model ()

GtkWidget *
gtk_tree_view_new_with_model (GtkTreeModel *model);

Создаёт новый виджет GtkTreeView с моделью, инициализированной в model .

gtk_tree_view_get_model ()

GtkTreeModel *
gtk_tree_view_get_model (GtkTreeView *tree_view);

Возвращает модель, на которой основан GtkTreeView. Возвращает NULL если модель не установлена.

gtk_tree_view_set_model ()

void
gtk_tree_view_set_model (GtkTreeView *tree_view,
                         GtkTreeModel *model);

Устанавливает модель для GtkTreeView. Если у tree_view уже есть установленная модель, она будет удалена перед установкой новой модели. Если model равно NULL, то старая модель будет удалена.

gtk_tree_view_get_selection ()

GtkTreeSelection *
gtk_tree_view_get_selection (GtkTreeView *tree_view);

Получает связанный с tree_view GtkTreeSelection.

gtk_tree_view_get_headers_visible ()

gboolean
gtk_tree_view_get_headers_visible (GtkTreeView *tree_view);

Возвращает TRUE, если заголовки на tree_view видны.

gtk_tree_view_set_headers_visible ()

void
gtk_tree_view_set_headers_visible (GtkTreeView *tree_view,
                                   gboolean headers_visible);

Устанавливает состояние видимости заголовков.

gtk_tree_view_columns_autosize ()

void
gtk_tree_view_columns_autosize (GtkTreeView *tree_view);

Изменяет ширину всех столбцов на оптимальную. Работает только после реализации виджета treeview.

gtk_tree_view_get_headers_clickable ()

gboolean
gtk_tree_view_get_headers_clickable (GtkTreeView *tree_view);

Возвращает, кликабельны ли все столбцы заголовков.

gtk_tree_view_set_headers_clickable ()

void
gtk_tree_view_set_headers_clickable (GtkTreeView *tree_view,
                                     gboolean setting);

Разрешить клик по заголовкам столбцов.

gtk_tree_view_set_activate_on_single-click ()

void
gtk_tree_view_set_activate_on_single_click
                               (GtkTreeView *tree_view,
                                gboolean single);

Приводит к тому, что сигнал “row-activated” будет испускаться при одном нажатии, а не двойном.

gtk_tree_view_get_activate_on-single-click ()

gboolean
gtk_tree_view_get_activate_on_single_click
                               (GtkTreeView *tree_view);

Получает настройку, установленную функцией gtk_tree_view_set_activate_on_single_click().

gtk_tree_view_append_column ()

int
gtk_tree_view_append_column (GtkTreeView *tree_view,
                             GtkTreeViewColumn *column);

Добавляет column в список столбцов. Если у tree_view включен режим “fixed_height”, то у column свойство “sizing” должно быть установлено как GTK_TREE_VIEW_COLUMN_FIXED.

gtk_tree_view_remove_column ()

int
gtk_tree_view_remove_column (GtkTreeView *tree_view,
                             GtkTreeViewColumn *column);

Удаляет column из tree_view .

gtk_tree_view_insert_column ()

int
gtk_tree_view_insert_column (GtkTreeView *tree_view,
                             GtkTreeViewColumn *column,
                             int position);

Это вставляет column в tree_view в позиции position. Если position равно -1, то столбец вставляется в конец. Если у tree_view включен режим «fixed_height», то у column свойство «sizing» должно быть установлено в GTK_TREE_VIEW_COLUMN_FIXED.

gtk_tree_view_insert_column_with_attributes ()

int
gtk_tree_view_insert_column_with_attributes
                               (GtkTreeView *tree_view,
                                int position,
                                const char *title,
                                GtkCellRenderer *cell,
                                ...);

Создаёт новый GtkTreeViewColumn и вставляет его в tree_view в позиции position. Если position равно -1, то новый столбец вставляется в конец. Столбец инициализируется заданными атрибутами. Если у tree_view включен режим «fixed_height», то у нового столбца свойство sizing будет установлено в GTK_TREE_VIEW_COLUMN_FIXED.

gtk_tree_view_insert_column_with_data_func ()

int
gtk_tree_view_insert_column_with_data_func
                               (GtkTreeView *tree_view,
                                int position,
                                const char *title,
                                GtkCellRenderer *cell,
                                GtkTreeCellDataFunc func,
                                gpointer data,
                                GDestroyNotify dnotify);

Функция для удобства вставки нового столбца в GtkTreeView с заданным отображением ячейки и функцией GtkTreeCellDataFunc для установки атрибутов отображения ячейки (обычно используя данные из модели). Смотрите также gtk_tree_view_column_set_cell_data_func(), gtk_tree_view_column_pack_start(). Если у tree_view включен режим «fixed_height», то у нового столбца свойство «sizing» будет установлено в GTK_TREE_VIEW_COLUMN_FIXED.

gtk_tree_view_get_n_columns ()

guint
gtk_tree_view_get_n_columns (GtkTreeView *tree_view);

Запрашивает количество столбцов в данном tree_view.

gtk_tree_view_get_column ()

GtkTreeViewColumn *
gtk_tree_view_get_column (GtkTreeView *tree_view,
                          int n);

Получает GtkTreeViewColumn по заданной позиции в tree_view.

gtk_tree_view_get_columns ()

GList *
gtk_tree_view_get_columns (GtkTreeView *tree_view);

Возвращает GList всех GtkTreeViewColumn в tree_view. Возвращённый список необходимо освободить с помощью g_list_free()

gtk_tree_view_move_column_after ()

void
gtk_tree_view_move_column_after (GtkTreeView *tree_view,
                                 GtkTreeViewColumn *column,
                                 GtkTreeViewColumn *base_column);

Перемещает column после base_column. Если base_column равно NULL, то column помещается на первое место.

gtk_tree_view_set_expander_column ()

void
gtk_tree_view_set_expander_column (GtkTreeView *tree_view,
                                   GtkTreeViewColumn *column);

Устанавливает столбец, в котором будет отображаться стрелка раскрытия. Он должен быть в tree_view . Если column равно NULL, то стрелка раскрытия всегда находится в первом видимом столбце.

Если вы не хотите отображать стрелку раскрытия в своём дереве, установите столбец раскрытия в скрытый столбец.

gtk_tree_view_get_expander_column ()

GtkTreeViewColumn *
gtk_tree_view_get_expander_column (GtkTreeView *tree_view);

Возвращает столбец, являющийся текущим столбцом раскрытия, или NULL , если он не был установлен. В этом столбце отображается стрелка раскрытия.

gtk_tree_view_set_column_drag_function ()

void
gtk_tree_view_set_column_drag_function
                               (GtkTreeView *tree_view,
                                GtkTreeViewColumnDropFunc func,
                                gpointer user_data,
                                GDestroyNotify destroy);

Устанавливает пользовательскую функцию для определения, куда можно переместить столбец при перетаскивании. Эта функция вызывается для каждой пары столбцов по очереди в начале перетаскивания столбца, чтобы определить, куда можно выполнить перемещение. Аргументы, передаваемые в func , следующие: tree_view , перетаскиваемый GtkTreeViewColumn, два GtkTreeViewColumn, определяющих место разгрузки, и user_data . Если любой из аргументов GtkTreeViewColumn для места разгрузки равен NULL, то они указывают на край. Если func установлено в NULL, то tree_view возвращается к поведению по умолчанию, позволяя перетаскивать любые столбцы в любое место.

gtk_tree_view_scroll_to_point ()

void
gtk_tree_view_scroll_to_point (GtkTreeView *tree_view,
                               int tree_x,
                               int tree_y);

Прокручивает представление дерева таким образом, чтобы верхний левый угол видимой области был в tree_x , tree_y , где tree_x и tree_y указаны в координатах дерева. tree_view должно быть реализовано перед вызовом этой функции. Если это не так, вы, вероятно, хотите использовать gtk_tree_view_scroll_to_cell().

Если tree_x или tree_y равны -1, то прокрутка в этом направлении не выполняется.

gtk_tree_view_scroll-to-cell ()

void
gtk_tree_view_scroll_to_cell (GtkTreeView *tree_view,
                              GtkTreePath *path,
                              GtkTreeViewColumn *column,
                              gboolean use_align,
                              float row_align,
                              float col_align);

Перемещает выравнивание tree_view в позицию, указанную column и path . Если column равно NULL, то горизонтальная прокрутка не выполняется. Аналогично, если path равно NULL, то вертикальная прокрутка не выполняется. По меньшей мере, один из column или path должен быть не-NULL. row_align определяет, куда помещается строка, а col_align определяет, куда помещается column. Оба значения должны быть в диапазоне от 0,0 до 1,0. 0,0 означает выравнивание по левому/верхнему краю, 1,0 — по правому/нижнему краю, 0,5 — по центру.

Если use_align равно FALSE, то аргументы выравнивания игнорируются, и дерево выполняет минимальную работу по прокрутке ячейки на экран. Это означает, что ячейка будет прокручена к краю, ближайшему к её текущей позиции. Если ячейка в настоящее время видна на экране, ничего не делается.

Эта функция работает только если модель установлена, и path является допустимой строкой в модели. Если модель изменяется до того, как tree_view реализована, отцентрированный путь будет изменён, чтобы отразить это изменение.

gtk_tree_view_set_cursor ()

void
gtk_tree_view_set_cursor (GtkTreeView *tree_view,
                          GtkTreePath *path,
                          GtkTreeViewColumn *focus_column,
                          gboolean start_editing);

Устанавливает текущий фокус клавиатуры на path и выбирает его. Это полезно, когда вы хотите сфокусировать внимание пользователя на определённой строке. Если focus_column не NULL, то фокус предоставляется столбцу, указанному им. Кроме того, если указан focus_column, а start_editing TRUE, то редактирование должно начаться в указанной ячейке. Эта функция часто сопровождается gtk_widget_grab_focus (tree_view ), чтобы предоставить фокус клавиатуры виджету. Обратите внимание, что редактирование может происходить только при отображении виджета.

Если path некорректно для model, текущий курсор (если есть) будет сброшен, и функция вернётся без ошибок.

gtk_tree_view_set_cursor_on_cell ()

void
gtk_tree_view_set_cursor_on_cell (GtkTreeView *tree_view,
                                  GtkTreePath *path,
                                  GtkTreeViewColumn *focus_column,
                                  GtkCellRenderer *focus_cell,
                                  gboolean start_editing);

Устанавливает текущий фокус клавиатуры на path и выбирает его. Это полезно, когда вы хотите сфокусировать внимание пользователя на определённой строке. Если focus_column не NULL, то фокус предоставляется столбцу, указанному им. Если focus_column и focus_cell не NULL, и focus_column содержит 2 или более редактируемых или активируемых ячеек, то фокус предоставляется ячейке, указанной focus_cell. Кроме того, если focus_column указано, и start_editing TRUE, то редактирование должно начаться в указанной ячейке. Эта функция часто сопровождается gtk_widget_grab_focus (tree_view ), чтобы предоставить фокус клавиатуры виджету. Обратите внимание, что редактирование может происходить только при отображении виджета.

Если path некорректно для model, текущий курсор (если есть) будет сброшен, и функция вернётся без ошибок.

gtk_tree_view_get_cursor ()

void
gtk_tree_view_get_cursor (GtkTreeView *tree_view,
                          GtkTreePath **path,
                          GtkTreeViewColumn **focus_column);

Заполняет path и focus_column текущим путём и столбцом фокуса. Если курсор не установлен, то *path будет NULL. Если ни один столбец не имеет фокуса, то *focus_column будет NULL.

Возвращённый GtkTreePath необходимо освободить с помощью gtk_tree_path_free(), когда вы закончите с ним.

gtk_tree_view_row_activated ()

void
gtk_tree_view_row_activated (GtkTreeView *tree_view,
                             GtkTreePath *path,
                             GtkTreeViewColumn *column);

Активирует ячейку, определяемую path и column.

gtk_tree_view_expand_all ()

void
gtk_tree_view_expand_all (GtkTreeView *tree_view);

Рекурсивно раскрывает все узлы в tree_view .

gtk_tree_view_collapse_all ()

void
gtk_tree_view_collapse_all (GtkTreeView *tree_view);

Рекурсивно сворачивает все видимые, раскрытые узлы в tree_view .

gtk_tree_view_expand-to-path ()

void
gtk_tree_view_expand_to_path (GtkTreeView *tree_view,
                              GtkTreePath *path);

Раскрывает строку по адресу path. Это также раскроет все родительские строки path по мере необходимости.

gtk_tree_view_expand_row ()

gboolean
gtk_tree_view_expand_row (GtkTreeView *tree_view,
                          GtkTreePath *path,
                          gboolean open_all);

Открывает строку, чтобы её дочерние элементы были видны.

gtk_tree_view_collapse_row ()

gboolean
gtk_tree_view_collapse_row (GtkTreeView *tree_view,
                            GtkTreePath *path);

Сворачивает строку (скрывает её дочерние строки, если они существуют).

gtk_tree_view_map_expanded_rows ()

void
gtk_tree_view_map_expanded_rows (GtkTreeView *tree_view,
                                 GtkTreeViewMappingFunc func,
                                 gpointer data);

Вызывает func для всех развернутых строк.

gtk_tree_view_row_expanded ()

gboolean
gtk_tree_view_row_expanded (GtkTreeView *tree_view,
                            GtkTreePath *path);

Возвращает TRUE, если узел, на который указывает path, развернут в tree_view.

gtk_tree_view_set_reorderable ()

void
gtk_tree_view_set_reorderable (GtkTreeView *tree_view,
                               gboolean reorderable);

Эта функция является вспомогательной функцией, позволяющей переупорядочивать модели, поддерживающие GtkTreeDragSourceIface и GtkTreeDragDestIface. И GtkTreeStore, и GtkListStore поддерживают эти интерфейсы. Если reorderable равно TRUE, то пользователь может переупорядочить модель, перетаскивая строки. Разработчик может отслеживать эти изменения, подключившись к сигналам модели «row-inserted» и «row-deleted». Переупорядочивание реализуется путём установки виджета дерева как источника и пункта назначения перетаскивания. Поэтому перетаскивание не может быть использовано для других целей в переупорядочиваемом представлении.

Эта функция не предоставляет никакого контроля над порядком — допускается любое переупорядочивание. Если требуется больший контроль, вам следует обрабатывать перетаскивание вручную.

gtk_tree_view_get_reorderable ()

gboolean
gtk_tree_view_get_reorderable (GtkTreeView *tree_view);

Возвращает, можно ли пользователю переупорядочить дерево с помощью перетаскивания. Смотрите gtk_tree_view_set_reorderable().

gtk_tree_view_get_path_at_pos ()

gboolean
gtk_tree_view_get_path_at_pos (GtkTreeView *tree_view,
                               int x,
                               int y,
                               GtkTreePath **path,
                               GtkTreeViewColumn **column,
                               int *cell_x,
                               int *cell_y);

Находит путь в точке (x , y ), относительно координат окна bin_window. То есть, x и y относятся к координатам событий. Координаты, относительные к виджету, необходимо преобразовать с помощью gtk_tree_view_convert_widget_to_bin_window_coords(). Это в основном используется для всплывающих меню. Если path не NULL, то он будет заполнен GtkTreePath в этой точке. Этот путь необходимо освободить с помощью gtk_tree_path_free(). Если column не NULL, то он будет заполнен столбцом в этой точке. cell_x и cell_y возвращают координаты, относительные к фону ячейки (т. е. background_area, переданному в gtk_cell_renderer_render()). Эта функция имеет смысл только если tree_view реализован. Поэтому эта функция всегда вернёт FALSE, если tree_view не реализован или не имеет модели.

Для преобразования координат виджета (например, тех, которые вы получаете из GtkWidget::query-tooltip), см. gtk_tree_view_convert_widget_to_bin_window_coords().

gtk_tree_view_is_blank_at_pos ()

gboolean
gtk_tree_view_is_blank_at_pos (GtkTreeView *tree_view,
                               int x,
                               int y,
                               GtkTreePath **path,
                               GtkTreeViewColumn **column,
                               int *cell_x,
                               int *cell_y);

Определяет, пуста ли точка (x , y ) в tree_view, т. е. в данной позиции нет содержимого ячейки и стрелки разворачивания. В этом случае позицию можно считать фоном. Возможно, вам захочется принять особые меры при нажатии на фон, например, очистить текущий выбор, иметь пользовательское контекстное меню или начать резиновое растягивание.

Координаты x и y должны быть относительными к координатам окна bin_window. Координаты, относительные к виджету, необходимо преобразовать с помощью gtk_tree_view_convert_widget_to_bin_window_coords().

Для преобразования координат виджета (например, тех, которые вы получаете из GtkWidget::query-tooltip), см. gtk_tree_view_convert_widget_to_bin_window_coords().

Аргументы path, column, cell_x и cell_y будут заполнены аналогично gtk_tree_view_get_path_at_pos(). Дополнительную информацию см. в gtk_tree_view_get_path_at_pos().

gtk_tree_view_get_cell_area ()

void
gtk_tree_view_get_cell_area (GtkTreeView *tree_view,
                             GtkTreePath *path,
                             GtkTreeViewColumn *column,
                             GdkRectangle *rect);

Заполняет прямоугольник ограничивающей рамки в координатах bin_window для ячейки в строке, указанной параметром path, и столбце, указанном параметром column. Если path имеет значение NULL, или указывает на путь, который в данный момент не отображается, поля y и height прямоугольника будут заполнены значением 0. Если column имеет значение NULL, поля x и width будут заполнены значением 0. Сумма всех прямоугольников ячеек не покрывает весь дерево; между строками есть дополнительные пиксели, например. Возвращаемый прямоугольник эквивалентен прямоугольнику cell_area, переданному в функцию gtk_cell_renderer_render(). Эта функция допустима только если tree_view реализовано.

gtk_tree_view_get_background_area ()

void
gtk_tree_view_get_background_area (GtkTreeView *tree_view,
                                   GtkTreePath *path,
                                   GtkTreeViewColumn *column,
                                   GdkRectangle *rect);

Заполняет прямоугольник ограничивающей рамки в координатах bin_window для ячейки в строке, указанной параметром path, и столбце, указанном параметром column. Если path имеет значение NULL, или указывает на узел, который не найден в дереве, поля y и height прямоугольника будут заполнены значением 0. Если column имеет значение NULL, поля x и width будут заполнены значением 0. Возвращаемый прямоугольник эквивалентен прямоугольнику background_area, переданному в функцию gtk_cell_renderer_render(). Эти области фона заполняют всю область bin_window. В отличие от cell_area, возвращаемого функцией gtk_tree_view_get_cell_area(), которая возвращает только саму ячейку, исключая окружающие границы и область расширения дерева.

gtk_tree_view_get_visible_rect ()

void
gtk_tree_view_get_visible_rect (GtkTreeView *tree_view,
                                GdkRectangle *visible_rect);

Заполняет visible_rect видимой областью буфера в координатах дерева. Преобразовать в координаты bin_window с помощью gtk_tree_view_convert_tree_to_bin_window_coords(). Координаты дерева начинаются с 0,0 для 0-й строки дерева и охватывают всю область прокрутки дерева.

gtk_tree_view_get_visible_range ()

gboolean
gtk_tree_view_get_visible_range (GtkTreeView *tree_view,
                                 GtkTreePath **start_path,
                                 GtkTreePath **end_path);

Устанавливает start_path и end_path в первую и последнюю видимую строку. Обратите внимание, что между ними могут быть невидимые строки.

Пути должны быть освобождены с помощью gtk_tree_path_free() после использования.

gtk_tree_view_convert_bin_window_to_tree_coords ()

void
gtk_tree_view_convert_bin_window_to_tree_coords
                               (GtkTreeView *tree_view,
                                int bx,
                                int by,
                                int *tx,
                                int *ty);

Преобразует координаты bin_window в координаты дерева (полной области прокрутки дерева).

gtk_tree_view_convert_bin_window_to_widget_coords ()

void
gtk_tree_view_convert_bin_window_to_widget_coords
                               (GtkTreeView *tree_view,
                                int bx,
                                int by,
                                int *wx,
                                int *wy);

Преобразует координаты окна bin_window в относительные координаты виджета.

gtk_tree_view_convert_tree_to_bin_window_coords ()

void
gtk_tree_view_convert_tree_to_bin_window_coords
                               (GtkTreeView *tree_view,
                                int tx,
                                int ty,
                                int *bx,
                                int *by);

Преобразует координаты дерева (координаты в полностью прокручиваемой области дерева) в координаты bin_window.

gtk_tree_view_convert_tree_to_widget_coords ()

void
gtk_tree_view_convert_tree_to_widget_coords
                               (GtkTreeView *tree_view,
                                int tx,
                                int ty,
                                int *wx,
                                int *wy);

Преобразует координаты дерева (координаты в полностью прокручиваемой области дерева) в координаты виджета.

gtk_tree_view_convert_widget_to_bin_window_coords ()

void
gtk_tree_view_convert_widget_to_bin_window_coords
                               (GtkTreeView *tree_view,
                                int wx,
                                int wy,
                                int *bx,
                                int *by);

Преобразует координаты виджета в координаты bin_window.

gtk_tree_view_convert_widget_to_tree_coords ()

void
gtk_tree_view_convert_widget_to_tree_coords
                               (GtkTreeView *tree_view,
                                int wx,
                                int wy,
                                int *tx,
                                int *ty);

Преобразует координаты виджета в координаты дерева (полностью прокручиваемой области дерева).

gtk_tree_view_enable_model_drag_dest ()

void
gtk_tree_view_enable_model_drag_dest (GtkTreeView *tree_view,
                                      GdkContentFormats *formats,
                                      GdkDragAction actions);

Превращает tree_view в пункт назначения перетаскивания для автоматического DND. Вызов этого метода устанавливает “reorderable” в FALSE.

gtk_tree_view_enable_model_drag_source ()

void
gtk_tree_view_enable_model_drag_source
                               (GtkTreeView *tree_view,
                                GdkModifierType start_button_mask,
                                GdkContentFormats *formats,
                                GdkDragAction actions);

Превращает tree_view в источник перетаскивания для автоматического DND. Вызов этого метода устанавливает “reorderable” в FALSE.

gtk_tree_view_unset_rows_drag_source ()

void
gtk_tree_view_unset_rows_drag_source (GtkTreeView *tree_view);

Отменяет действие gtk_tree_view_enable_model_drag_source(). Вызов этого метода устанавливает “reorderable” в FALSE.

gtk_tree_view_unset_rows_drag_dest ()

void
gtk_tree_view_unset_rows_drag_dest (GtkTreeView *tree_view);

Отменяет действие gtk_tree_view_enable_model_drag_dest(). Вызов этого метода устанавливает “reorderable” в FALSE.

gtk_tree_view_set_drag_dest_row ()

void
gtk_tree_view_set_drag_dest_row (GtkTreeView *tree_view,
                                 GtkTreePath *path,
                                 GtkTreeViewDropPosition pos);

Устанавливает строку, которая выделяется для обратной связи. Если path равно NULL, существующее выделение удаляется.

gtk_tree_view_get_drag_dest_row ()

void
gtk_tree_view_get_drag_dest_row (GtkTreeView *tree_view,
                                 GtkTreePath **path,
                                 GtkTreeViewDropPosition *pos);

Получает информацию о выделенной для обратной связи строке.

gtk_tree_view_get_dest_row_at_pos ()

gboolean
gtk_tree_view_get_dest_row_at_pos (GtkTreeView *tree_view,
                                   int drag_x,
                                   int drag_y,
                                   GtkTreePath **path,
                                   GtkTreeViewDropPosition *pos);

Определяет целевую строку для заданной позиции. drag_x и drag_y ожидаются в координатах виджета. Эта функция имеет смысл только если tree_view реализована. Поэтому эта функция всегда вернёт FALSE если tree_view не реализована или не имеет модели.

gtk_tree_view_create_row_drag_icon ()

GdkPaintable *
gtk_tree_view_create_row_drag_icon (GtkTreeView *tree_view,
                                    GtkTreePath *path);

Создаёт представление строки в path в виде cairo_surface_t. Этот образ используется в виде иконки перетаскивания.

gtk_tree_view_set_enable_search ()

void
gtk_tree_view_set_enable_search (GtkTreeView *tree_view,
                                 gboolean enable_search);

Если enable_search установлено, то пользователь может ввести текст для поиска в дереве интерактивно (это иногда называется "поиск с автодополнением").

Обратите внимание, что даже если это FALSE, пользователь по-прежнему может инициировать поиск с помощью сочетания клавиш “start-interactive-search”.

gtk_tree_view_get_search_equal_func ()

GtkTreeViewSearchEqualFunc
gtk_tree_view_get_search_equal_func (GtkTreeView *tree_view);

Возвращает функцию сравнения, которая используется в настоящее время.

[skip]

gtk_tree_view_set_search_equal_func ()

void
gtk_tree_view_set_search_equal_func (GtkTreeView *tree_view,
                                     GtkTreeViewSearchEqualFunc search_equal_func,
                                     gpointer search_user_data,
                                     GDestroyNotify search_destroy);

Устанавливает функцию сравнения для интерактивных возможностей поиска; обратите внимание, что, подобно strcmp(), возвращая 0 для равенства GtkTreeViewSearchEqualFunc возвращает FALSE при совпадении.

gtk_tree_view_get_search_entry ()

GtkEditable *
gtk_tree_view_get_search_entry (GtkTreeView *tree_view);

Возвращает GtkEntry, который в настоящее время используется в качестве интерактивной строки поиска для tree_view. В случае использования встроенной строки, будет возвращено NULL.

gtk_tree_view_set_search_entry ()

void
gtk_tree_view_set_search_entry (GtkTreeView *tree_view,
                                GtkEditable *entry);

Устанавливает строку, которую код интерактивного поиска будет использовать для этого tree_view. Это полезно, когда вы хотите предоставить строку поиска в нашем интерфейсе в любое время в фиксированном положении. Передача NULL для entry заставит код интерактивного поиска снова использовать встроенную всплывающую строку.

gtk_tree_view_get_fixed_height_mode ()

gboolean
gtk_tree_view_get_fixed_height_mode (GtkTreeView *tree_view);

Возвращает, включен ли режим фиксированной высоты для tree_view.

gtk_tree_view_set_fixed_height_mode ()

void
gtk_tree_view_set_fixed_height_mode (GtkTreeView *tree_view,
                                     gboolean enable);

Включает или отключает режим фиксированной высоты tree_view. Режим фиксированной высоты ускоряет GtkTreeView, предполагая, что все строки имеют одинаковую высоту. Включайте этот параметр только в том случае, если все строки имеют одинаковую высоту, а все столбцы имеют тип GTK_TREE_VIEW_COLUMN_FIXED.

gtk_tree_view_get_hover-selection ()

gboolean
gtk_tree_view_get_hover_selection (GtkTreeView *tree_view);

Возвращает, включен ли режим выбора наведением для tree_view.

gtk_tree_view_set_hover-selection ()

void
gtk_tree_view_set_hover_selection (GtkTreeView *tree_view,
                                   gboolean hover);

Включает или отключает режим выбора наведением для tree_view. Выбор наведением перемещает выделенную строку за указателем. В настоящее время это работает только для режимов выбора GTK_SELECTION_SINGLE и GTK_SELECTION_BROWSE.

gtk_tree_view_get_hover-expand ()

gboolean
gtk_tree_view_get_hover_expand (GtkTreeView *tree_view);

Возвращает, включен ли режим расширения наведением для tree_view.

gtk_tree_view_set_hover-expand ()

void
gtk_tree_view_set_hover_expand (GtkTreeView *tree_view,
                                gboolean expand);

Включает или отключает режим расширения наведением для tree_view. Режим расширения наведением вызывает расширение или сворачивание строк, если указатель перемещается по ним.

GtkTreeViewRowSeparatorFunc ()

gboolean
(*GtkTreeViewRowSeparatorFunc) (GtkTreeModel *model,
                                GtkTreeIter *iter,
                                gpointer data);

Тип функции для определения, должна ли строка, на которую указывает iter, отображаться как разделитель. Общий способ реализации — иметь булевый столбец в модели, значения которого возвращает функция GtkTreeViewRowSeparatorFunc.

gtk_tree_view_get_row_separator_func ()

GtkTreeViewRowSeparatorFunc
gtk_tree_view_get_row_separator_func (GtkTreeView *tree_view);

Возвращает текущую функцию разделителя строк.

[skip]

gtk_tree_view_set_row_separator_func ()

void
gtk_tree_view_set_row_separator_func (GtkTreeView *tree_view,
                                      GtkTreeViewRowSeparatorFunc func,
                                      gpointer data,
                                      GDestroyNotify destroy);

Устанавливает функцию разделителя строк, используемую для определения, должна ли строка отображаться как разделитель. Если функция разделителя строк NULL, разделители не отображаются. Это значение по умолчанию.

gtk_tree_view_get_rubber_banding ()

gboolean
gtk_tree_view_get_rubber_banding (GtkTreeView *tree_view);

Возвращает, включена ли функция резинового выделения для tree_view . Если режим выбора — GTK_SELECTION_MULTIPLE, резиновое выделение позволит пользователю выбирать несколько строк, перетаскивая мышь.

gtk_tree_view_set_rubber_banding ()

void
gtk_tree_view_set_rubber_banding (GtkTreeView *tree_view,
                                  gboolean enable);

Включает или выключает резиновое выделение в tree_view . Если режим выбора — GTK_SELECTION_MULTIPLE, резиновое выделение позволит пользователю выбирать несколько строк, перетаскивая мышь.

gtk_tree_view_is_rubber_banding_active ()

gboolean
gtk_tree_view_is_rubber_banding_active
                               (GtkTreeView *tree_view);

Возвращает, выполняется ли в данный момент операция резинового выделения в tree_view .

gtk_tree_view_get_enable_tree_lines ()

gboolean
gtk_tree_view_get_enable_tree_lines (GtkTreeView *tree_view);

Возвращает, включены ли линии дерева в tree_view .

gtk_tree_view_set_enable_tree_lines ()

void
gtk_tree_view_set_enable_tree_lines (GtkTreeView *tree_view,
                                     gboolean enabled);

Устанавливает, следует ли рисовать линии, соединяющие раскрывающие элементы в tree_view. Для списков это не оказывает никакого визуального эффекта.

gtk_tree_view_get_grid_lines ()

GtkTreeViewGridLines
gtk_tree_view_get_grid_lines (GtkTreeView *tree_view);

Возвращает, какие линии сетки включены в tree_view .

gtk_tree_view_set_grid_lines ()

void
gtk_tree_view_set_grid_lines (GtkTreeView *tree_view,
                              GtkTreeViewGridLines grid_lines);

Устанавливает, какие линии сетки отображать в tree_view .

gtk_tree_view_set_tooltip_row ()

void
gtk_tree_view_set_tooltip_row (GtkTreeView *tree_view,
                               GtkTooltip *tooltip,
                               GtkTreePath *path);

Устанавливает область подсказки для tooltip в область, покрываемую строкой по индексу path. См. также gtk_tree_view_set_tooltip_column() для более простого варианта. См. также gtk_tooltip_set_tip_area().

gtk_tree_view_set_tooltip_cell ()

void
gtk_tree_view_set_tooltip_cell (GtkTreeView *tree_view,
                                GtkTooltip *tooltip,
                                GtkTreePath *path,
                                GtkTreeViewColumn *column,
                                GtkCellRenderer *cell);

Устанавливает область подсказки для tooltip в область, общую для path, column и cell. Например, если path — NULL, а column задано, область подсказки будет установлена на всю область, покрываемую column. См. также gtk_tooltip_set_tip_area().

Обратите внимание, что если path не указано, а cell задано и является частью столбца, содержащего раскрывающийся элемент, подсказка может не отображаться и скрываться в неправильном положении. В таких случаях path должен быть установлен на текущий узел под курсором мыши для корректной работы этой функции.

См. также gtk_tree_view_set_tooltip_column() для более простого варианта.

gtk_tree_view_get_tooltip_context ()

gboolean
gtk_tree_view_get_tooltip_context (GtkTreeView *tree_view,
                                   int x,
                                   int y,
                                   gboolean keyboard_tip,
                                   GtkTreeModel **model,
                                   GtkTreePath **path,
                                   GtkTreeIter *iter);

Эта функция должна использоваться в обработчике сигнала “query-tooltip” для GtkTreeView. Значения x, y и keyboard_tip, полученные в обработчике сигнала, должны передаваться в эту функцию без изменений.

Возвращаемое значение указывает, существует ли строка дерева в заданных координатах (TRUE) или нет (FALSE) для подсказок при наведении мыши. Для подсказок при нажатии клавиш возвращаемая строка будет строкой курсора. Когда TRUE, любые из model, path и iter, которые были предоставлены, будут установлены на указание этой строки и соответствующей модели. x и y всегда будут преобразовываться в относительные значения к окну tree_view bin_window, если keyboard_tooltip равно FALSE.

gtk_tree_view_get_tooltip_column ()

int
gtk_tree_view_get_tooltip_column (GtkTreeView *tree_view);

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

gtk_tree_view_set_tooltip_column ()

void
gtk_tree_view_set_tooltip_column (GtkTreeView *tree_view,
                                  int column);

Если планируется использовать простые (только текст) подсказки для целых строк, вы можете использовать эту функцию для автоматического обработки GtkTreeView. column должен быть установлен на столбец в модели tree_view, содержащий текст подсказки, или -1 для отключения этой функции.

При включении “has-tooltip” будет установлено в значение TRUE, и tree_view подключит обработчик сигнала “query-tooltip”.

Обратите внимание, что обработчик сигнала устанавливает текст с помощью gtk_tooltip_set_markup(), поэтому символы &, < и т.д. необходимо экранировать в тексте.

Сигнал “columns-changed”

void
user_function (GtkTreeView *tree_view,
               gpointer     user_data)

Количество столбцов в виджете GtkTreeView изменилось.

Флаги: Run Last

Сигнал “cursor-changed”

void
user_function (GtkTreeView *tree_view,
               gpointer     user_data)

Изменилось положение курсора (выделенной ячейки).

Флаги: Run Last

Сигнал “expand-collapse-cursor-row”

gboolean
user_function (GtkTreeView *treeview,
               gboolean     arg1,
               gboolean     arg2,
               gboolean     arg3,
               gpointer     user_data)

Флаги: Действие

Сигнал “move-cursor”

gboolean
user_function (GtkTreeView    *tree_view,
               GtkMovementStep step,
               int             direction,
               gboolean        extend,
               gboolean        modify,
               gpointer        user_data)

Сигнал “move-cursor” — это сигнал для привязки горячих клавиш, который испускается при нажатии пользователем клавиш управления курсором.

Приложения не должны подключаться к этому сигналу, но могут испускать его с помощью g_signal_emit_by_name(), если им нужно управлять курсором программно. В отличие от gtk_tree_view_set_cursor() и gtk_tree_view_set_cursor_on_cell(), при горизонтальном перемещении “move-cursor” не сбрасывает текущий выбор.

Флаги: Действие

Сигнал “row-activated”

void
user_function (GtkTreeView       *tree_view,
               GtkTreePath       *path,
               GtkTreeViewColumn *column,
               gpointer           user_data)

Сигнал «row-activated» испускается, когда вызывается метод gtk_tree_view_row_activated(), когда пользователь дважды щелкает строку GtkTreeView со свойством «activate-on-single-click» установленным в FALSE, или когда пользователь один раз щелкает строку со свойством «activate-on-single-click» установленным в TRUE. Также он испускается, когда нередактируемая строка выбрана, и нажата одна из клавиш: Пробел, Shift+Пробел, Возврат или Ввод.

Для обработки выбора см. концептуальный обзор виджета дерева здесь и GtkTreeSelection.

Флаги: Действие

Сигнал “row-collapsed”

void
user_function (GtkTreeView *tree_view,
               GtkTreeIter *iter,
               GtkTreePath *path,
               gpointer     user_data)

Данная строка была свёрнута (дочерние узлы скрыты).

Флаги: Run Last

Сигнал “row-expanded”

void
user_function (GtkTreeView *tree_view,
               GtkTreeIter *iter,
               GtkTreePath *path,
               gpointer     user_data)

Данная строка была развернута (дочерние узлы отображены).

Флаги: Run Last

Сигнал “select-all”

gboolean
user_function (GtkTreeView *treeview,
               gpointer     user_data)

Флаги: Действие

Сигнал “select-cursor-parent”

gboolean
user_function (GtkTreeView *treeview,
               gpointer     user_data)

Флаги: Действие

Сигнал “select-cursor-row”

gboolean
user_function (GtkTreeView *treeview,
               gboolean     arg1,
               gpointer     user_data)

Флаги: Действие

Сигнал “start-interactive-search”

gboolean
user_function (GtkTreeView *treeview,
               gpointer     user_data)

Флаги: Действие

Сигнал “test-collapse-row”

gboolean
user_function (GtkTreeView *tree_view,
               GtkTreeIter *iter,
               GtkTreePath *path,
               gpointer     user_data)

Данная строка собирается свёрнуться (спрятать её дочерние узлы). Используйте этот сигнал, если нужно управлять возможностью сворачивания отдельных строк.

Флаги: Run Last

Сигнал “test-expand-row”

gboolean
user_function (GtkTreeView *tree_view,
               GtkTreeIter *iter,
               GtkTreePath *path,
               gpointer     user_data)

Данная строка собирается для раскрытия (отображения дочерних узлов). Используйте этот сигнал, если вам нужно управлять раскрываемостью отдельных строк.

Флаги: Run Last

Сигнал “toggle-cursor-row”

gboolean
user_function (GtkTreeView *treeview,
               gpointer     user_data)

Флаги: Action

Сигнал “unselect-all”

gboolean
user_function (GtkTreeView *treeview,
               gpointer     user_data)

Флаги: Action