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,
                               gint column,
                               const gchar *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 ()

gint
gtk_tree_view_get_level_indentation (GtkTreeView *tree_view);

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

Since: 2.12

gtk_tree_view_get_show_expanders ()

gboolean
gtk_tree_view_get_show_expanders (GtkTreeView *tree_view);

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

Since: 2.12

gtk_tree_view_set_level_indentation ()

void
gtk_tree_view_set_level_indentation (GtkTreeView *tree_view,
                                     gint indentation);

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

Since: 2.12

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(). Для списков это не имеет видимого эффекта.

Since: 2.12

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);

Возвращает GtkTreeSelection, связанный с tree_view .

gtk_tree_view_get_hadjustment ()

GtkAdjustment *
gtk_tree_view_get_hadjustment (GtkTreeView *tree_view);

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

gtk_tree_view_set_hadjustment ()

void
gtk_tree_view_set_hadjustment (GtkTreeView *tree_view,
                               GtkAdjustment *adjustment);

Устанавливает GtkAdjustment для горизонтальной прокрутки.

gtk_tree_view_get_vadjustment ()

GtkAdjustment *
gtk_tree_view_get_vadjustment (GtkTreeView *tree_view);

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

gtk_tree_view_set_vadjustment ()

void
gtk_tree_view_set_vadjustment (GtkTreeView *tree_view,
                               GtkAdjustment *adjustment);

Устанавливает GtkAdjustment для вертикальной прокрутки.

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);

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

gtk_tree_view_get_headers_clickable ()

gboolean
gtk_tree_view_get_headers_clickable (GtkTreeView *tree_view);

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

С версии: 2.10

gtk_tree_view_set_headers_clickable ()

void
gtk_tree_view_set_headers_clickable (GtkTreeView *tree_view,
                                     gboolean setting);

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

gtk_tree_view_set_rules_hint ()

void
gtk_tree_view_set_rules_hint (GtkTreeView *tree_view,
                              gboolean setting);

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

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

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

gtk_tree_view_get_rules_hint ()

gboolean
gtk_tree_view_get_rules_hint (GtkTreeView *tree_view);

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

gtk_tree_view_set_activate_on_single-click ()

void
gtk_tree_view_set_activate_on_single_click
                               (GtkTreeView *tree_view,
                                gboolean single);

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

С: 3.8

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().

С: 3.8

gtk_tree_view_append_column ()

gint
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 ()

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

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

gtk_tree_view_insert_column ()

gint
gtk_tree_view_insert_column (GtkTreeView *tree_view,
                             GtkTreeViewColumn *column,
                             gint 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 ()

gint
gtk_tree_view_insert_column_with_attributes
                               (GtkTreeView *tree_view,
                                gint position,
                                const gchar *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 ()

gint
gtk_tree_view_insert_column_with_data_func
                               (GtkTreeView *tree_view,
                                gint position,
                                const gchar *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.

Since: 3.4

gtk_tree_view_get_column ()

GtkTreeViewColumn *
gtk_tree_view_get_column (GtkTreeView *tree_view,
                          gint 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);

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

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,
                               gint tree_x,
                               gint 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,
                              gfloat row_align,
                              gfloat 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, текущий курсор (если есть) будет сброшен, и функция вернётся без ошибки.

Since: 2.2

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, если необходимо.

Since: 2.2

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,
                               gint x,
                               gint y,
                               GtkTreePath **path,
                               GtkTreeViewColumn **column,
                               gint *cell_x,
                               gint *cell_y);

Находит путь в точке (x , y ), относительно координат окна bin_window (см. gtk_tree_view_get_bin_window()). То есть, x и y относятся к координатам события. x и y должны поступать из события на tree_view только там, где event->window == gtk_tree_view_get_bin_window(). Это в первую очередь для таких вещей, как всплывающие меню. Если 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,
                               gint x,
                               gint y,
                               GtkTreePath **path,
                               GtkTreeViewColumn **column,
                               gint *cell_x,
                               gint *cell_y);

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

Координаты x и y, которые предоставляются, должны быть относительными к координатам bin_window. То есть x и y должны исходить из события на tree_view, где event->window == gtk_tree_view_get_bin_window().

Для преобразования координат виджета (например, тех, которые вы получаете из 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().

Since: 3.0

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() после использования.

С: 2.8

gtk_tree_view_get_bin_window ()

GdkWindow *
gtk_tree_view_get_bin_window (GtkTreeView *tree_view);

Возвращает окно, в которое tree_view рендерит. Это используется в первую очередь для сравнения с event->window , чтобы подтвердить, что событие на tree_view находится в правильном окне.

gtk_tree_view_convert_bin_window_to_tree_coords ()

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

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

С: 2.12

gtk_tree_view_convert_bin_window_to_widget_coords ()

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

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

С: 2.12

gtk_tree_view_convert_tree_to_bin_window_coords ()

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

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

С: 2.12

gtk_tree_view_convert_tree-to-widget-coords ()

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

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

С: 2.12

gtk_tree_view_convert_widget_to_bin_window_coords ()

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

Преобразует координаты виджета в координаты для bin_window (см. gtk_tree_view_get_bin_window()).

С версии: 2.12

gtk_tree_view_convert_widget_to_tree_coords ()

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

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

С версии: 2.12

gtk_tree_view_enable_model_drag_dest ()

void
gtk_tree_view_enable_model_drag_dest (GtkTreeView *tree_view,
                                      const GtkTargetEntry *targets,
                                      gint n_targets,
                                      GdkDragAction actions);

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

gtk_tree_view_enable_model_drag_source ()

void
gtk_tree_view_enable_model_drag_source
                               (GtkTreeView *tree_view,
                                GdkModifierType start_button_mask,
                                const GtkTargetEntry *targets,
                                gint n_targets,
                                GdkDragAction actions);

Превращает tree_view в источник перетаскивания для автоматического перетаскивания. Вызов этого метода устанавливает “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,
                                   gint drag_x,
                                   gint drag_y,
                                   GtkTreePath **path,
                                   GtkTreeViewDropPosition *pos);

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

gtk_tree_view_create_row_drag_icon ()

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

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

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_enable_search ()

gboolean
gtk_tree_view_get_enable_search (GtkTreeView *tree_view);

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

gtk_tree_view_get_search_column ()

gint
gtk_tree_view_get_search_column (GtkTreeView *tree_view);

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

gtk_tree_view_set_search_column ()

void
gtk_tree_view_set_search_column (GtkTreeView *tree_view,
                                 gint column);

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

Если столбец поиска установлен, пользователи могут использовать привязку клавиш «start-interactive-search», чтобы открыть всплывающее окно поиска. Свойство enable-search управляет тем, будет ли ввод текста также запускать интерактивный поиск.

Обратите внимание, что column относится к столбцу текущей модели. Столбец поиска сбрасывается до -1 при изменении модели.

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 ()

GtkEntry *
gtk_tree_view_get_search_entry (GtkTreeView *tree_view);

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

Since: 2.10

gtk_tree_view_set_search_entry ()

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

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

С: 2.10

GtkTreeViewSearchPositionFunc ()

void
(*GtkTreeViewSearchPositionFunc) (GtkTreeView *tree_view,
                                  GtkWidget *search_dialog,
                                  gpointer user_data);

gtk_tree_view_get_search_position_func ()

GtkTreeViewSearchPositionFunc
gtk_tree_view_get_search_position_func
                               (GtkTreeView *tree_view);

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

[skip]

С: 2.10

gtk_tree_view_set_search-position-func ()

void
gtk_tree_view_set_search_position_func
                               (GtkTreeView *tree_view,
                                GtkTreeViewSearchPositionFunc func,
                                gpointer data,
                                GDestroyNotify destroy);

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

С: 2.10

gtk_tree_view_get_fixed_height_mode ()

gboolean
gtk_tree_view_get_fixed_height_mode (GtkTreeView *tree_view);

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

С: 2.6

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.

С: 2.6

gtk_tree_view_get_hover-selection ()

gboolean
gtk_tree_view_get_hover_selection (GtkTreeView *tree_view);

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

С: 2.6

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.

С: 2.6

gtk_tree_view_get_hover-expand ()

gboolean
gtk_tree_view_get_hover_expand (GtkTreeView *tree_view);

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

С: 2.6

gtk_tree_view_set_hover-expand ()

void
gtk_tree_view_set_hover_expand (GtkTreeView *tree_view,
                                gboolean expand);

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

С: 2.6

GtkTreeDestroyCountFunc ()

void
(*GtkTreeDestroyCountFunc) (GtkTreeView *tree_view,
                            GtkTreePath *path,
                            gint children,
                            gpointer user_data);

gtk_tree_view_set_destroy_count_func ()

void
gtk_tree_view_set_destroy_count_func (GtkTreeView *tree_view,
                                      GtkTreeDestroyCountFunc func,
                                      gpointer data,
                                      GDestroyNotify destroy);

Функция практически никогда не должна использоваться. Она предназначена для внутреннего использования ATK для определения количества видимых дочерних элементов, которые удаляются, когда пользователь сворачивает строку или строка удаляется.

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]

С: 2.6

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, разделители не отображаются. Это значение по умолчанию.

С: 2.6

gtk_tree_view_get_rubber_banding ()

gboolean
gtk_tree_view_get_rubber_banding (GtkTreeView *tree_view);

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

С: 2.10

gtk_tree_view_set_rubber_banding ()

void
gtk_tree_view_set_rubber_banding (GtkTreeView *tree_view,
                                  gboolean enable);

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

С: 2.10

gtk_tree_view_is_rubber_banding_active ()

gboolean
gtk_tree_view_is_rubber_banding_active
                               (GtkTreeView *tree_view);

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

С: 2.12

gtk_tree_view_get_enable_tree_lines ()

gboolean
gtk_tree_view_get_enable_tree_lines (GtkTreeView *tree_view);

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

С: 2.10

gtk_tree_view_set_enable_tree_lines ()

void
gtk_tree_view_set_enable_tree_lines (GtkTreeView *tree_view,
                                     gboolean enabled);

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

С: 2.10

gtk_tree_view_get_grid_lines ()

GtkTreeViewGridLines
gtk_tree_view_get_grid_lines (GtkTreeView *tree_view);

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

С версии: 2.10

gtk_tree_view_set_grid_lines ()

void
gtk_tree_view_set_grid_lines (GtkTreeView *tree_view,
                              GtkTreeViewGridLines grid_lines);

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

С версии: 2.10

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().

С версии: 2.12

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() для более простого варианта.

С версии: 2.12

gtk_tree_view_get_tooltip_context ()

gboolean
gtk_tree_view_get_tooltip_context (GtkTreeView *tree_view,
                                   gint *x,
                                   gint *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 всегда будут преобразованы для относительности к bin_window tree_view, если keyboard_tooltip равно FALSE.

С версии: 2.12

gtk_tree_view_get_tooltip_column ()

gint
gtk_tree_view_get_tooltip_column (GtkTreeView *tree_view);

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

С: 2.12

gtk_tree_view_set_tooltip_column ()

void
gtk_tree_view_set_tooltip_column (GtkTreeView *tree_view,
                                  gint column);

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

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

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

С: 2.12

Сигнал “columns-changed”

void
user_function (GtkTreeView *tree_view,
               gpointer     user_data)

Количество столбцов в списке изменилось.

Флаги: 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)

Флаги: Action

Сигнал “move-cursor”

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

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

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

Флаги: Action

Сигнал “row-activated”

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

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

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

Флаги: Action

Сигнал “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)

Флаги: Action

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

gboolean
user_function (GtkTreeView *treeview,
               gpointer     user_data)

Флаги: Action

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

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

Флаги: Action

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

gboolean
user_function (GtkTreeView *treeview,
               gpointer     user_data)

Флаги: Action

Сигнал “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