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_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 boxes, связанные с 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 является NULL, 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