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 в пикселях.

С: 2.12

gtk_tree_view_get_show_expanders ()

gboolean
gtk_tree_view_get_show_expanders (GtkTreeView *tree_view);

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

С: 2.12

gtk_tree_view_set_level_indentation ()

void
gtk_tree_view_set_level_indentation (GtkTreeView *tree_view,
                                     gint indentation);

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

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

С: 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 .

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

С: 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 прямоугольника будут заполнены нулями. Если column имеет значение NULL, поля x и width будут заполнены нулями. Сумма всех прямоугольников ячеек не покрывает весь дерево; между строками есть дополнительные пиксели, например. Возвращаемый прямоугольник эквивалентен 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);

Заполняет прямоугольник границ в координатах окна ячейки для строки, указанной path, и столбца, указанного column. Если path равен NULL или указывает на узел, не найденный в дереве, поля y и height прямоугольника будут заполнены 0. Если column равен NULL, поля x и width будут заполнены 0. Возвращаемый прямоугольник эквивалентен background_area, переданному в gtk_cell_renderer_render(). Эти области фона заполняют всё окно ячейки. В отличие от 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 текущей видимой областью буфера в координатах дерева. Преобразуйте в координаты окна ячейки с помощью 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);

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

С: 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 в целевой элемент для автоматического перетаскивания (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,
                                const GtkTargetEntry *targets,
                                gint n_targets,
                                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,
                                   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);

Создаёт представление строки в 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, пользователь всё равно может инициировать поиск с помощью сочетания клавиш «начать-интерактивный-поиск».

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 в качестве столбца, в котором интерактивный код поиска должен выполнять поиск в текущей модели.

Если столбец поиска установлен, пользователи могут использовать сочетание клавиш «начать-интерактивный-поиск», чтобы отобразить всплывающее окно поиска. Свойство 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.

С момента: 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 всегда будут преобразовываться в относительные к tree_view`s bin_window, если 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)

Количество столбцов виджета 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)

Флаги: Action

Сигнал “move-cursor”

gboolean
user_function (GtkTreeView    *tree_view,
               GtkMovementStep step,
               gint            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(), когда пользователь дважды щелкает строку в GtkTreeView с установленным свойством "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)

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

Флаги: Выполнить последним

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

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

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

Флаги: Выполнить последним

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

gboolean
user_function (GtkTreeView *treeview,
               gpointer     user_data)

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

Сигнал “unselect-all”

gboolean
user_function (GtkTreeView *treeview,
               gpointer     user_data)

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