Spec-Zone.ru › GTK 4.0

GtkGridView

GtkGridView — Виджет для отображения таблиц

Функции

GtkWidget * gtk_grid_view_new ()
void gtk_grid_view_set_model ()
GtkSelectionModel * gtk_grid_view_get_model ()
void gtk_grid_view_set_max_columns ()
guint gtk_grid_view_get_max_columns ()
void gtk_grid_view_set_min_columns ()
guint gtk_grid_view_get_min_columns ()
void gtk_grid_view_set_single_click_activate ()
gboolean gtk_grid_view_get_single_click_activate ()
void gtk_grid_view_set_enable_rubberband ()
gboolean gtk_grid_view_get_enable_rubberband ()
void gtk_grid_view_set_factory ()
GtkListItemFactory * gtk_grid_view_get_factory ()

Свойства

gboolean enable-rubberband Чтение / Запись
GtkListItemFactory * factory Чтение / Запись
guint max-columns Чтение / Запись
guint min-columns Чтение / Запись
GtkSelectionModel * model Чтение / Запись
gboolean single-click-activate Чтение / Запись

Сигналы

void activate Выполнить последним

Действия

list.activate-item u

Типы и значения

GtkGridView

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkListBase
                ╰── GtkGridView

Реализованные интерфейсы

GtkGridView реализует GtkAccessible, GtkBuildable, GtkConstraintTarget, GtkOrientable и GtkScrollable.

Файлы включения

#include <gtk/gtk.h>

Описание

GtkGridView — это виджет для представления представления большой динамической таблицы элементов.

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

GtkGridView позволяет пользователю выбирать элементы в соответствии с характеристиками выбора модели. Для моделей, которые позволяют выбирать несколько элементов, можно включить _резиновый выбор_, используя “enable-rubberband”.

Для получения дополнительной информации о фреймворке виджетов списков см. обзор.

Узлы CSS

gridview
├── child
│
├── child
│
┊
╰── [rubberband]

GtkGridView использует единственный узел CSS с именем gridview. Каждый дочерний элемент использует единственный узел CSS с именем child. Для резинового выбора используется под-узел с именем rubberband.

Доступность

GtkGridView использует роль GTK_ACCESSIBLE_ROLE_GRID, а элементы используют роль GTK_ACCESSIBLE_ROLE_GRID_CELL.

Функции

gtk_grid_view_new ()

GtkWidget *
gtk_grid_view_new (GtkSelectionModel *model,
                   GtkListItemFactory *factory);

Создаёт новую GtkGridView, которая использует заданный factory для сопоставления элементов с виджетами.

Функция принимает аргументы в собственность, поэтому вы можете написать код, подобный grid_view = gtk_grid_view_new (create_model(), gtk_builder_list_item_factory_new_from_resource ("/resource.ui"));

Параметры

model

используемая модель или NULL.

[allow-none][transfer full]

factory

фабрика для заполнения элементов или NULL.

[allow-none][transfer full]

Возвращает

новую GtkGridView, использующую заданный model и factory

gtk_grid_view_set_model ()

void
gtk_grid_view_set_model (GtkGridView *self,
                         GtkSelectionModel *model);

Устанавливает GtkSelectionModel для использования

Параметры

self

a GtkGridView

model

используемая модель или NULL для значения null.

[allow-none][transfer none]

gtk_grid_view_get_model ()

GtkSelectionModel *
gtk_grid_view_get_model (GtkGridView *self);

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

Параметры

self

a GtkGridView

Возвращает

Используемую модель.

[nullable][transfer none]

gtk_grid_view_set_max_columns ()

void
gtk_grid_view_set_max_columns (GtkGridView *self,
                               guint max_columns);

Устанавливает максимальное количество столбцов для использования. Это число должно быть не меньше 1.

Если max_columns меньше минимального значения, установленного с помощью gtk_grid_view_set_min_columns(), используется это значение.

Параметры

self

a GtkGridView

max_columns

Максимальное количество столбцов

gtk_grid_view_get_max_columns ()

guint
gtk_grid_view_get_max_columns (GtkGridView *self);

Возвращает максимальное количество столбцов, которое будет использоваться сеткой.

Параметры

self

a GtkGridView

Возвращает

Максимальное количество столбцов

gtk_grid_view_set_min_columns ()

void
gtk_grid_view_set_min_columns (GtkGridView *self,
                               guint min_columns);

Устанавливает минимальное количество столбцов для использования. Это число должно быть не меньше 1.

Если min_columns меньше минимального значения, установленного с помощью gtk_grid_view_set_max_columns(), это значение игнорируется.

Параметры

self

a GtkGridView

min_columns

Минимальное количество столбцов

gtk_grid_view_get_min_columns ()

guint
gtk_grid_view_get_min_columns (GtkGridView *self);

Возвращает минимальное количество столбцов, которое будет использоваться сеткой.

Параметры

self

a GtkGridView

Возвращает

Минимальное количество столбцов

gtk_grid_view_set_single_click_activate ()

void
gtk_grid_view_set_single_click_activate
                               (GtkGridView *self,
                                gboolean single_click_activate);

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

Параметры

self

a GtkGridView

single_click_activate

TRUE для активации элементов при одиночном нажатии

gtk_grid_view_get_single_click_activate ()

gboolean
gtk_grid_view_get_single_click_activate
                               (GtkGridView *self);

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

Параметры

self

a GtkListView

Возвращает

TRUE если элементы активируются при одиночном нажатии

gtk_grid_view_set_enable_rubberband ()

void
gtk_grid_view_set_enable_rubberband (GtkGridView *self,
                                     gboolean enable_rubberband);

Устанавливает, могут ли выделения изменяться при перетаскивании мышью.

Параметры

self

a GtkGridView

enable_rubberband

TRUE для включения резинового выделения

gtk_grid_view_get_enable_rubberband ()

gboolean
gtk_grid_view_get_enable_rubberband (GtkGridView *self);

Возвращает, могут ли строки выбираться перетаскиванием мышью.

Параметры

self

a GtkGridView

Возвращает

TRUE если резиновое выделение включено

gtk_grid_view_set_factory ()

void
gtk_grid_view_set_factory (GtkGridView *self,
                           GtkListItemFactory *factory);

Устанавливает GtkListItemFactory для заполнения элементов списка.

Параметры

self

a GtkGridView

factory

используемая фабрика или NULL для значения null.

[allow-none][transfer none]

gtk_grid_view_get_factory ()

GtkListItemFactory *
gtk_grid_view_get_factory (GtkGridView *self);

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

Параметры

self

a GtkGridView

Возвращает

Используемая фабрика.

[nullable][transfer none]

Типы и значения

GtkGridView

typedef struct _GtkGridView GtkGridView;

GtkGridView — это реализация виджета списка, которая организует свои элементы в сетку.

Подробное описание свойств

Свойство “enable-rubberband”

  “enable-rubberband”        gboolean

Разрешить резиновое выделение

Владелец: GtkGridView

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство “factory”

  “factory”                  GtkListItemFactory *

Фабрика для заполнения элементов списка

Владелец: GtkGridView

Флаги: Чтение / Запись

Свойство “max-columns”

  “max-columns”              guint

Максимальное количество столбцов на строку

Если это число меньше, чем GtkGridView:min-columns, используется это значение вместо него.

Владелец: GtkGridView

Флаги: Чтение / Запись

Допустимые значения: >= 1

Значение по умолчанию: 7

Свойство “min-columns”

  “min-columns”              guint

Минимальное количество столбцов на строку

Владелец: GtkGridView

Флаги: Чтение / Запись

Допустимые значения: >= 1

Значение по умолчанию: 1

Свойство “model”

  “model”                    GtkSelectionModel *

Модель для отображаемых элементов

Владелец: GtkGridView

Флаги: Чтение / Запись

Свойство “single-click-activate”

  “single-click-activate”    gboolean

Активировать строки при однократном нажатии и выделять их при наведении

Владелец: GtkGridView

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Подробное описание сигналов

Сигнал “activate”

void
user_function (GtkGridView *self,
               guint        position,
               gpointer     user_data)

Сигнал ::activate генерируется, когда ячейка была активирована пользователем, обычно с помощью действия GtkGridView|list.activate-item.

Это позволяет удобно обрабатывать активацию в gridview. Подробнее о том, как использовать этот сигнал, см. в GtkListItem:activatable.

Параметры

self

The GtkGridView

position

позиция активируемого элемента

user_data

пользовательские данные, заданные при подключении обработчика сигнала.

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

Подробное описание действий

Действие “list.activate-item”

Активирует элемент, указанный в position, с помощью генерации сигнала GtkGridView::activate.

Тип параметра: u

Параметры

position

позиция активируемого элемента

См. также

GtkSelectionModel, GtkListView, GtkColumnView

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkGridView.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API