GtkFlowBox

gtk_flow_box_new ()

GtkWidget *
gtk_flow_box_new (void);

Создаёт GtkFlowBox.

С момента: 3.12

gtk_flow_box_insert ()

void
gtk_flow_box_insert (GtkFlowBox *box,
                     GtkWidget *widget,
                     gint position);

Вставляет widget в box на позиции position .

Если задана функция сортировки, виджет фактически будет вставлен в рассчитанную позицию, и эта функция имеет тот же эффект, что и gtk_container_add().

Если position равно -1 или больше общего количества дочерних элементов в box, то widget будет добавлен в конец.

С момента: 3.12

gtk_flow_box_get_child_at_index ()

GtkFlowBoxChild *
gtk_flow_box_get_child_at_index (GtkFlowBox *box,
                                 gint idx);

Возвращает n-ый дочерний элемент в box .

С момента: 3.12

gtk_flow_box_get_child_at_pos ()

GtkFlowBoxChild *
gtk_flow_box_get_child_at_pos (GtkFlowBox *box,
                               gint x,
                               gint y);

Возвращает дочерний элемент по координатам (x, y).

С момента: 3.22.6

gtk_flow_box_set_hadjustment ()

void
gtk_flow_box_set_hadjustment (GtkFlowBox *box,
                              GtkAdjustment *adjustment);

Подключает настройку для обработки фокуса в box. Настройка также используется для автоматического прокрутки при резиновом выделении. Смотрите gtk_scrolled_window_get_hadjustment() для типичного способа получения настройки и gtk_flow_box_set_vadjustment() для настройки вертикальной настройки.

Настройки должны быть в пикселях и в той же системе координат, что и выделение для непосредственных дочерних элементов поля.

С момента: 3.12

gtk_flow_box_set_vadjustment ()

void
gtk_flow_box_set_vadjustment (GtkFlowBox *box,
                              GtkAdjustment *adjustment);

Подключает настройку для обработки фокуса в box. Настройка также используется для автоматического прокрутки при резиновом выделении. Смотрите gtk_scrolled_window_get_vadjustment() для типичного способа получения настройки, и gtk_flow_box_set_hadjustment() для настройки горизонтальной настройки.

Настройки должны быть в пикселях и в той же системе координат, что и выделение для непосредственных дочерних элементов поля.

С момента: 3.12

gtk_flow_box_set_homogeneous ()

void
gtk_flow_box_set_homogeneous (GtkFlowBox *box,
                              gboolean homogeneous);

Устанавливает свойство “homogeneous” box, определяющее, будут ли все дочерние элементы box иметь одинаковое пространство в поле.

С момента: 3.12

gtk_flow_box_get_homogeneous ()

gboolean
gtk_flow_box_get_homogeneous (GtkFlowBox *box);

Возвращает, является ли поле однородным (все дочерние элементы имеют одинаковый размер). Смотрите gtk_box_set_homogeneous().

С момента: 3.12

gtk_flow_box_set_row_spacing ()

void
gtk_flow_box_set_row_spacing (GtkFlowBox *box,
                              guint spacing);

Устанавливает вертикальное расстояние между дочерними элементами. См. свойство “row-spacing”.

С момента: 3.12

gtk_flow_box_get_row_spacing ()

guint
gtk_flow_box_get_row_spacing (GtkFlowBox *box);

Получает вертикальное расстояние.

С: 3.12

gtk_flow_box_set_column_spacing ()

void
gtk_flow_box_set_column_spacing (GtkFlowBox *box,
                                 guint spacing);

Устанавливает горизонтальное расстояние между элементами. См. свойство “column-spacing”.

С: 3.12

gtk_flow_box_get_column_spacing ()

guint
gtk_flow_box_get_column_spacing (GtkFlowBox *box);

Получает горизонтальное расстояние.

С: 3.12

gtk_flow_box_set_min_children_per_line ()

void
gtk_flow_box_set_min_children_per_line
                               (GtkFlowBox *box,
                                guint n_children);

Устанавливает минимальное количество элементов в строке для box перед выравниванием.

С: 3.12

gtk_flow_box_get_min_children_per_line ()

guint
gtk_flow_box_get_min_children_per_line
                               (GtkFlowBox *box);

Получает минимальное количество элементов в строке.

С: 3.12

gtk_flow_box_set_max_children_per_line ()

void
gtk_flow_box_set_max_children_per_line
                               (GtkFlowBox *box,
                                guint n_children);

Устанавливает максимальное количество элементов, для которых запрашивается и выделяется место в ориентации box.

Установка максимального числа элементов в строке ограничивает общий запрос на естественный размер не более чем n_children элементов в заданной ориентации.

С: 3.12

gtk_flow_box_get_max_children_per_line ()

guint
gtk_flow_box_get_max_children_per_line
                               (GtkFlowBox *box);

Получает максимальное количество элементов в строке.

С: 3.12

gtk_flow_box_set_activate_on_single-click ()

void
gtk_flow_box_set_activate_on_single_click
                               (GtkFlowBox *box,
                                gboolean single);

Если single равно TRUE, элементы будут активироваться при нажатии один раз, в противном случае необходимо дважды нажать.

С: 3.12

gtk_flow_box_get_activate_on-single-click ()

gboolean
gtk_flow_box_get_activate_on_single_click
                               (GtkFlowBox *box);

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

С: 3.12

GtkFlowBoxForeachFunc ()

void
(*GtkFlowBoxForeachFunc) (GtkFlowBox *box,
                          GtkFlowBoxChild *child,
                          gpointer user_data);

Функция, используемая в gtk_flow_box_selected_foreach(). Будет вызвана для каждого выбранного элемента box.

С: 3.12

gtk_flow_box_selected_foreach ()

void
gtk_flow_box_selected_foreach (GtkFlowBox *box,
                               GtkFlowBoxForeachFunc func,
                               gpointer data);

Вызывает функцию для каждого выбранного элемента.

Обратите внимание, что выборку нельзя изменить внутри этой функции.

С: 3.12

gtk_flow_box_get_selected_children ()

GList *
gtk_flow_box_get_selected_children (GtkFlowBox *box);

Создаёт список всех выбранных дочерних элементов.

С момента: 3.12

gtk_flow_box_select_child ()

void
gtk_flow_box_select_child (GtkFlowBox *box,
                           GtkFlowBoxChild *child);

Выбирает один дочерний элемент box, если режим выбора позволяет это.

С момента: 3.12

gtk_flow_box_unselect_child ()

void
gtk_flow_box_unselect_child (GtkFlowBox *box,
                             GtkFlowBoxChild *child);

Снимает выбор с одного дочернего элемента box, если режим выбора позволяет это.

С момента: 3.12

gtk_flow_box_select_all ()

void
gtk_flow_box_select_all (GtkFlowBox *box);

Выбирает все дочерние элементы box, если режим выбора позволяет это.

С момента: 3.12

gtk_flow_box_unselect_all ()

void
gtk_flow_box_unselect_all (GtkFlowBox *box);

Снимает выбор со всех дочерних элементов box, если режим выбора позволяет это.

С момента: 3.12

gtk_flow_box_set_selection_mode ()

void
gtk_flow_box_set_selection_mode (GtkFlowBox *box,
                                 GtkSelectionMode mode);

Устанавливает способ работы выбора в box. Смотрите GtkSelectionMode для деталей.

С момента: 3.12

gtk_flow_box_get_selection_mode ()

GtkSelectionMode
gtk_flow_box_get_selection_mode (GtkFlowBox *box);

Получает режим выбора box.

С момента: 3.12

GtkFlowBoxFilterFunc ()

gboolean
(*GtkFlowBoxFilterFunc) (GtkFlowBoxChild *child,
                         gpointer user_data);

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

С момента: 3.12

gtk_flow_box_set_filter_func ()

void
gtk_flow_box_set_filter_func (GtkFlowBox *box,
                              GtkFlowBoxFilterFunc filter_func,
                              gpointer user_data,
                              GDestroyNotify destroy);

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

Функция filter_func будет вызываться для каждого дочернего элемента после вызова, и она будет продолжать вызываться каждый раз, когда дочерний элемент изменяется (через gtk_flow_box_child_changed()) или когда вызывается gtk_flow_box_invalidate_filter().

Обратите внимание, что использование функции фильтрации несовместимо с использованием модели (см. gtk_flow_box_bind_model()).

С момента: 3.12

gtk_flow_box_invalidate_filter ()

void
gtk_flow_box_invalidate_filter (GtkFlowBox *box);

Обновляет фильтрацию всех дочерних элементов.

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

С момента: 3.12

GtkFlowBoxSortFunc ()

gint
(*GtkFlowBoxSortFunc) (GtkFlowBoxChild *child1,
                       GtkFlowBoxChild *child2,
                       gpointer user_data);

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

С версии: 3.12

gtk_flow_box_set_sort_func ()

void
gtk_flow_box_set_sort_func (GtkFlowBox *box,
                            GtkFlowBoxSortFunc sort_func,
                            gpointer user_data,
                            GDestroyNotify destroy);

Установив функцию сортировки для box, можно динамически переупорядочить дочерние элементы ящика, основываясь на их содержимом.

Функция sort_func будет вызываться для каждого дочернего элемента после вызова и будет продолжать вызываться каждый раз, когда дочерний элемент изменяется (через gtk_flow_box_child_changed()) и при вызове gtk_flow_box_invalidate_sort().

Обратите внимание, что использование функции сортировки несовместимо с использованием модели (см. gtk_flow_box_bind_model()).

С версии: 3.12

gtk_flow_box_invalidate_sort ()

void
gtk_flow_box_invalidate_sort (GtkFlowBox *box);

Обновляет сортировку всех дочерних элементов.

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

С версии: 3.12

GtkFlowBoxCreateWidgetFunc ()

GtkWidget *
(*GtkFlowBoxCreateWidgetFunc) (gpointer item,
                               gpointer user_data);

Вызывается для ящиков Flow, привязанных к GListModel с помощью gtk_flow_box_bind_model() для каждого элемента, добавленного в модель.

С версии: 3.18

gtk_flow_box_bind_model ()

void
gtk_flow_box_bind_model (GtkFlowBox *box,
                         GListModel *model,
                         GtkFlowBoxCreateWidgetFunc create_widget_func,
                         gpointer user_data,
                         GDestroyNotify user_data_free_func);

Привязывает model к box.

Если box уже был привязан к модели, эта предыдущая привязка уничтожается.

Содержимое box очищается, а затем заполняется виджетами, представляющими элементы из model. box обновляется каждый раз, когда model изменяется. Если model пустая, box остается пустой.

Не определено добавлять или удалять виджеты напрямую (например, с помощью gtk_flow_box_insert() или gtk_container_add()), пока box привязан к модели.

Обратите внимание, что использование модели несовместимо с фильтрацией и сортировкой в GtkFlowBox. При использовании модели фильтрация и сортировка должны быть реализованы в модели.

С версии: 3.18

gtk_flow_box_child_new ()

GtkWidget *
gtk_flow_box_child_new (void);

Создает новый GtkFlowBoxChild, который будет использоваться в качестве дочернего элемента GtkFlowBox.

С версии: 3.12

gtk_flow_box_child_get_index ()

gint
gtk_flow_box_child_get_index (GtkFlowBoxChild *child);

Возвращает текущий индекс child в контейнере GtkFlowBox.

С версии: 3.12

gtk_flow_box_child_is_selected ()

gboolean
gtk_flow_box_child_is_selected (GtkFlowBoxChild *child);

Возвращает, выбран ли child в настоящее время в его контейнере GtkFlowBox.

С момента: 3.12

gtk_flow_box_child_changed ()

void
gtk_flow_box_child_changed (GtkFlowBoxChild *child);

Помечает child как изменённый, вызывая обновление любого состояния, зависящего от него. Это влияет на сортировку и фильтрацию.

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

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

С момента: 3.12