GtkFlowBox

gtk_flow_box_new ()

GtkWidget *
gtk_flow_box_new (void);

Создаёт GtkFlowBox.

gtk_flow_box_insert ()

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

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

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

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

gtk_flow_box_remove ()

void
gtk_flow_box_remove (GtkFlowBox *box,
                     GtkWidget *widget);

Удаляет дочерний элемент из box .

gtk_flow_box_get_child_at_index ()

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

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

gtk_flow_box_get_child_at_pos ()

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

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

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() для установки вертикальной корректировки.

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

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() для установки горизонтальной корректировки.

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

gtk_flow_box_set_homogeneous ()

void
gtk_flow_box_set_homogeneous (GtkFlowBox *box,
                              gboolean homogeneous);

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

gtk_flow_box_get_homogeneous ()

gboolean
gtk_flow_box_get_homogeneous (GtkFlowBox *box);

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

gtk_flow_box_set_row_spacing ()

void
gtk_flow_box_set_row_spacing (GtkFlowBox *box,
                              guint spacing);

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

gtk_flow_box_get_row_spacing ()

guint
gtk_flow_box_get_row_spacing (GtkFlowBox *box);

Получает вертикальный интервал.

gtk_flow_box_set_column_spacing ()

void
gtk_flow_box_set_column_spacing (GtkFlowBox *box,
                                 guint spacing);

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

gtk_flow_box_get_column_spacing ()

guint
gtk_flow_box_get_column_spacing (GtkFlowBox *box);

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

gtk_flow_box_set_min_children_per_line ()

void
gtk_flow_box_set_min_children_per_line
                               (GtkFlowBox *box,
                                guint n_children);

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

gtk_flow_box_get_min_children_per_line ()

guint
gtk_flow_box_get_min_children_per_line
                               (GtkFlowBox *box);

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

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 элементов в заданной ориентации.

gtk_flow_box_get_max_children_per_line ()

guint
gtk_flow_box_get_max_children_per_line
                               (GtkFlowBox *box);

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

gtk_flow_box_set_activate_on_single_click ()

void
gtk_flow_box_set_activate_on_single_click
                               (GtkFlowBox *box,
                                gboolean single);

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

gtk_flow_box_get_activate_on_single_click ()

gboolean
gtk_flow_box_get_activate_on_single_click
                               (GtkFlowBox *box);

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

GtkFlowBoxForeachFunc ()

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

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

gtk_flow_box_selected_foreach ()

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

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

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

gtk_flow_box_get_selected_children ()

GList *
gtk_flow_box_get_selected_children (GtkFlowBox *box);

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

gtk_flow_box_select-child ()

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

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

gtk_flow_box_unselect-child ()

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

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

gtk_flow_box_select_all ()

void
gtk_flow_box_select_all (GtkFlowBox *box);

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

gtk_flow_box_unselect_all ()

void
gtk_flow_box_unselect_all (GtkFlowBox *box);

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

gtk_flow_box_set_selection_mode ()

void
gtk_flow_box_set_selection_mode (GtkFlowBox *box,
                                 GtkSelectionMode mode);

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

gtk_flow_box_get_selection_mode ()

GtkSelectionMode
gtk_flow_box_get_selection_mode (GtkFlowBox *box);

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

GtkFlowBoxFilterFunc ()

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

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

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

gtk_flow_box_invalidate_filter ()

void
gtk_flow_box_invalidate_filter (GtkFlowBox *box);

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

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

GtkFlowBoxSortFunc ()

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

Функция сравнения двух дочерних элементов для определения порядка.

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

gtk_flow_box_invalidate_sort ()

void
gtk_flow_box_invalidate_sort (GtkFlowBox *box);

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

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

GtkFlowBoxCreateWidgetFunc ()

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

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

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()) в то время, как box привязан к модели.

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

gtk_flow_box_child_new ()

GtkWidget *
gtk_flow_box_child_new (void);

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

gtk_flow_box_child_set_child ()

void
gtk_flow_box_child_set_child (GtkFlowBoxChild *self,
                              GtkWidget *child);

Устанавливает дочерний виджет для self .

gtk_flow_box_child_get_child ()

GtkWidget *
gtk_flow_box_child_get_child (GtkFlowBoxChild *self);

Получает дочерний виджет для self .

gtk_flow_box_child_get_index ()

int
gtk_flow_box_child_get_index (GtkFlowBoxChild *child);

Получает текущий индекс child в контейнере GtkFlowBox.

gtk_flow_box_child_is_selected ()

gboolean
gtk_flow_box_child_is_selected (GtkFlowBoxChild *child);

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

gtk_flow_box_child_changed ()

void
gtk_flow_box_child_changed (GtkFlowBoxChild *child);

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

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

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