GtkTreeSelection

GtkTreeSelectionFunc ()

gboolean
(*GtkTreeSelectionFunc) (GtkTreeSelection *selection,
                         GtkTreeModel *model,
                         GtkTreePath *path,
                         gboolean path_currently_selected,
                         gpointer data);

Функция, используемая gtk_tree_selection_set_select_function() для фильтрации возможности выделения строки. Она вызывается всякий раз, когда может измениться состояние строки. Возвращаемое значение TRUE указывает selection, что изменение выделения разрешено.

GtkTreeSelectionForeachFunc ()

void
(*GtkTreeSelectionForeachFunc) (GtkTreeModel *model,
                                GtkTreePath *path,
                                GtkTreeIter *iter,
                                gpointer data);

Функция, используемая gtk_tree_selection_selected_foreach() для обработки всех выделенных строк. Она будет вызвана для каждой выделенной строки в представлении.

gtk_tree_selection_set_mode ()

void
gtk_tree_selection_set_mode (GtkTreeSelection *selection,
                             GtkSelectionMode type);

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

gtk_tree_selection_get_mode ()

GtkSelectionMode
gtk_tree_selection_get_mode (GtkTreeSelection *selection);

Возвращает режим выделения для selection. См. gtk_tree_selection_set_mode().

gtk_tree_selection_set_select_function ()

void
gtk_tree_selection_set_select_function
                               (GtkTreeSelection *selection,
                                GtkTreeSelectionFunc func,
                                gpointer data,
                                GDestroyNotify destroy);

Устанавливает функцию выделения.

Если установлена, эта функция вызывается перед выделением или снятием выделения с узла, предоставляя контроль над выделенными узлами. Функция выделения должна возвращать TRUE, если состояние узла может быть переключено, и FALSE, если состояние узла должно остаться неизменным.

gtk_tree_selection_get_select_function ()

GtkTreeSelectionFunc
gtk_tree_selection_get_select_function
                               (GtkTreeSelection *selection);

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

[skip]

Since: 2.14

gtk_tree_selection_get_user_data ()

gpointer
gtk_tree_selection_get_user_data (GtkTreeSelection *selection);

Возвращает данные пользователя для функции выделения.

[skip]

gtk_tree_selection_get_tree_view ()

GtkTreeView *
gtk_tree_selection_get_tree_view (GtkTreeSelection *selection);

Возвращает связанное представление дерева для selection.

gtk_tree_selection_get_selected ()

gboolean
gtk_tree_selection_get_selected (GtkTreeSelection *selection,
                                 GtkTreeModel **model,
                                 GtkTreeIter *iter);

Устанавливает iter на текущий выбранный узел, если selection установлено в GTK_SELECTION_SINGLE или GTK_SELECTION_BROWSE. iter может быть NULL, если вы хотите только проверить, есть ли у selection выбранные узлы. model заполняется текущей моделью для удобства. Эта функция не будет работать, если вы используете selection как GTK_SELECTION_MULTIPLE.

gtk_tree_selection_selected_foreach ()

void
gtk_tree_selection_selected_foreach (GtkTreeSelection *selection,
                                     GtkTreeSelectionForeachFunc func,
                                     gpointer data);

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

gtk_tree_selection_get_selected_rows ()

GList *
gtk_tree_selection_get_selected_rows (GtkTreeSelection *selection,
                                      GtkTreeModel **model);

Создаёт список путей всех выделенных строк. Кроме того, если вы планируете изменять модель после вызова этой функции, вы можете преобразовать возвращённый список в список GtkTreeRowReferences. Для этого вы можете использовать gtk_tree_row_reference_new().

Для освобождения возвращаемого значения используйте:

g_list_free_full(list,(GDestroyNotify) gtk_tree_path_free);

Since: 2.2

gtk_tree_selection_count_selected_rows ()

gint
gtk_tree_selection_count_selected_rows
                               (GtkTreeSelection *selection);

Возвращает количество строк, выделенных в tree .

Since: 2.2

gtk_tree_selection-select-path ()

void
gtk_tree_selection_select_path (GtkTreeSelection *selection,
                                GtkTreePath *path);

Выделить строку по path .

gtk_tree_selection_unselect_path ()

void
gtk_tree_selection_unselect_path (GtkTreeSelection *selection,
                                  GtkTreePath *path);

Снимает выделение со строки по path .

gtk_tree_selection_path_is_selected ()

gboolean
gtk_tree_selection_path_is_selected (GtkTreeSelection *selection,
                                     GtkTreePath *path);

Возвращает TRUE, если строка, на которую указывает path, в данный момент выделена. Если path не указывает на допустимую позицию, возвращается FALSE.

gtk_tree_selection_unselect_iter ()

void
gtk_tree_selection_unselect_iter (GtkTreeSelection *selection,
                                  GtkTreeIter *iter);

Отменяет выделение указанного итератора.

gtk_tree_selection_iter_is_selected ()

gboolean
gtk_tree_selection_iter_is_selected (GtkTreeSelection *selection,
                                     GtkTreeIter *iter);

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

gtk_tree_selection_select_all ()

void
gtk_tree_selection_select_all (GtkTreeSelection *selection);

Выделяет все узлы. Режим selection должен быть установлен в режим GTK_SELECTION_MULTIPLE.

gtk_tree_selection_unselect_all ()

void
gtk_tree_selection_unselect_all (GtkTreeSelection *selection);

Отменяет выделение всех узлов.

gtk_tree_selection_select_range ()

void
gtk_tree_selection_select_range (GtkTreeSelection *selection,
                                 GtkTreePath *start_path,
                                 GtkTreePath *end_path);

Выделяет диапазон узлов, определяемый start_path и end_path включительно. Режим selection должен быть установлен в режим GTK_SELECTION_MULTIPLE.

gtk_tree_selection_unselect_range ()

void
gtk_tree_selection_unselect_range (GtkTreeSelection *selection,
                                   GtkTreePath *start_path,
                                   GtkTreePath *end_path);

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

Since: 2.2