GtkGridLayout

GtkGridLayout — Менеджер компоновки для виджетов в виде таблицы

Функции

GtkLayoutManager *	gtk_grid_layout_new ()
void	gtk_grid_layout_set_row_homogeneous ()
gboolean	gtk_grid_layout_get_row_homogeneous ()
void	gtk_grid_layout_set_row_spacing ()
guint	gtk_grid_layout_get_row_spacing ()
void	gtk_grid_layout_set_column_homogeneous ()
gboolean	gtk_grid_layout_get_column_homogeneous ()
void	gtk_grid_layout_set_column_spacing ()
guint	gtk_grid_layout_get_column_spacing ()
void	gtk_grid_layout_set_row_baseline_position ()
GtkBaselinePosition	gtk_grid_layout_get_row_baseline_position ()
void	gtk_grid_layout_set_baseline_row ()
int	gtk_grid_layout_get_baseline_row ()
void	gtk_grid_layout_child_set_column ()
int	gtk_grid_layout_child_get_column ()
void	gtk_grid_layout_child_set_row ()
int	gtk_grid_layout_child_get_row ()
void	gtk_grid_layout_child_set_column_span ()
int	gtk_grid_layout_child_get_column_span ()
void	gtk_grid_layout_child_set_row_span ()
int	gtk_grid_layout_child_get_row_span ()

Свойства

int	baseline-row	Чтение/Запись
gboolean	column-homogeneous	Чтение/Запись
int	column-spacing	Чтение/Запись
gboolean	row-homogeneous	Чтение/Запись
int	row-spacing	Чтение/Запись
int	column	Чтение/Запись
int	column-span	Чтение/Запись
int	row	Чтение/Запись
int	row-span	Чтение/Запись

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

	GtkGridLayout
	GtkGridLayoutChild

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

    GObject
    ├── GtkLayoutChild
    │   ╰── GtkGridLayoutChild
    ╰── GtkLayoutManager
        ╰── GtkGridLayout

Файлы заголовков

#include <gtk/gtk.h>

Описание

GtkGridLayout — менеджер компоновки, который размещает дочерние виджеты в строках и столбцах с произвольными позициями и горизонтальными/вертикальными интервалами.

У дочерних элементов есть "точка привязки", определяемая горизонтальным и вертикальным индексом ячейки, которую они занимают; дочерние элементы могут занимать несколько строк или столбцов. Свойства компоновки для установки точек привязки и интервалов устанавливаются с помощью GtkGridLayoutChild, связанного с каждым дочерним виджетом.

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

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

Функции

gtk_grid_layout_new ()

GtkLayoutManager *
gtk_grid_layout_new (void);

Создаёт новый GtkGridLayout.

Возвращает

созданный GtkGridLayout

gtk_grid_layout_set_row_homogeneous ()

void
gtk_grid_layout_set_row_homogeneous (GtkGridLayout *grid,
                                     gboolean homogeneous);

Устанавливает, должны ли все строки grid иметь одинаковую высоту.

Параметры

grid	a GtkGridLayout
homogeneous	`TRUE` для однородных строк

gtk_grid_layout_get_row_homogeneous ()

gboolean
gtk_grid_layout_get_row_homogeneous (GtkGridLayout *grid);

Проверяет, должны ли все строки grid иметь одинаковую высоту.

Параметры

grid

a GtkGridLayout

Возвращает

TRUE если строки однородные, и FALSE в противном случае

gtk_grid_layout_set_row_spacing ()

void
gtk_grid_layout_set_row_spacing (GtkGridLayout *grid,
                                 guint spacing);

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

Параметры

grid	a GtkGridLayout
spacing	расстояние между строками в пикселях

gtk_grid_layout_get_row_spacing ()

guint
gtk_grid_layout_get_row_spacing (GtkGridLayout *grid);

Возвращает расстояние, установленное с помощью gtk_grid_layout_set_row_spacing().

Параметры

grid

a GtkGridLayout

Возвращает

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

gtk_grid_layout_set_column_homogeneous ()

void
gtk_grid_layout_set_column_homogeneous
                               (GtkGridLayout *grid,
                                gboolean homogeneous);

Устанавливает, должны ли все столбцы grid иметь одинаковую ширину.

Параметры

grid	a GtkGridLayout
homogeneous	`TRUE` для однородных столбцов

gtk_grid_layout_get_column_homogeneous ()

gboolean
gtk_grid_layout_get_column_homogeneous
                               (GtkGridLayout *grid);

Проверяет, должны ли все столбцы grid иметь одинаковую ширину.

Параметры

grid

a GtkGridLayout

Возвращает

TRUE если столбцы однородные, и FALSE в противном случае

gtk_grid_layout_set_column_spacing ()

void
gtk_grid_layout_set_column_spacing (GtkGridLayout *grid,
                                    guint spacing);

Устанавливает расстояние между последовательными столбцами.

Параметры

grid	a GtkGridLayout
spacing	расстояние между столбцами в пикселях

gtk_grid_layout_get_column_spacing ()

guint
gtk_grid_layout_get_column_spacing (GtkGridLayout *grid);

Возвращает расстояние, установленное с помощью gtk_grid_layout_set_column_spacing().

Параметры

grid

a GtkGridLayout

Возвращает

расстояние между последовательными столбцами

gtk_grid_layout_set_row_baseline_position ()

void
gtk_grid_layout_set_row_baseline_position
                               (GtkGridLayout *grid,
                                int row,
                                GtkBaselinePosition pos);

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

Параметры

grid	a GtkGridLayout
row	индекс строки
pos	a GtkBaselinePosition

gtk_grid_layout_get_row_baseline_position ()

GtkBaselinePosition
gtk_grid_layout_get_row_baseline_position
                               (GtkGridLayout *grid,
                                int row);

Возвращает положение базовой линии row, установленное с помощью gtk_grid_layout_set_row_baseline_position(), или значение по умолчанию GTK_BASELINE_POSITION_CENTER.

Параметры

grid	a GtkGridLayout
row	индекс строки

Возвращает

положение базовой линии row

gtk_grid_layout_set_baseline_row ()

void
gtk_grid_layout_set_baseline_row (GtkGridLayout *grid,
                                  int row);

Устанавливает строку, определяющую глобальную базовую линию для всей сетки.

Каждая строка сетки может иметь свою локальную базовую линию, но только одна из них является глобальной, то есть будет базовой линией в родительском элементе grid .

Параметры

grid	a GtkGridLayout
row	индекс строки

gtk_grid_layout_get_baseline_row ()

int
gtk_grid_layout_get_baseline_row (GtkGridLayout *grid);

Возвращает строку, установленную с помощью gtk_grid_layout_set_baseline_row().

Параметры

grid

a GtkGridLayout

Возвращает

глобальная строка базовой линии

gtk_grid_layout_child_set_column ()

void
gtk_grid_layout_child_set_column (GtkGridLayoutChild *child,
                                  int column);

Устанавливает номер столбца для присоединения левой стороны child.

Параметры

child	a GtkGridLayoutChild
column	точка присоединения `child`

gtk_grid_layout_child_get_column ()

int
gtk_grid_layout_child_get_column (GtkGridLayoutChild *child);

Возвращает номер столбца, к которому child прикрепляет свою левую сторону.

Параметры

child

элемент GtkGridLayoutChild

Возвращаемое значение

номер столбца

gtk_grid_layout_child_set_row ()

void
gtk_grid_layout_child_set_row (GtkGridLayoutChild *child,
                               int row);

Устанавливает строку, в которой следует разместить child.

Параметры

child	элемент GtkGridLayoutChild
row	строка для `child`

gtk_grid_layout_child_get_row ()

int
gtk_grid_layout_child_get_row (GtkGridLayoutChild *child);

Возвращает номер строки, к которой child прикрепляет свою верхнюю сторону.

Параметры

child

элемент GtkGridLayoutChild

Возвращаемое значение

номер строки

gtk_grid_layout_child_set_column_span ()

void
gtk_grid_layout_child_set_column_span (GtkGridLayoutChild *child,
                                       int span);

Устанавливает количество столбцов, которое child охватывает.

Параметры

child	элемент GtkGridLayoutChild
span	протяжённость `child`

gtk_grid_layout_child_get_column_span ()

int
gtk_grid_layout_child_get_column_span (GtkGridLayoutChild *child);

Возвращает количество столбцов, которое child охватывает.

Параметры

child

элемент GtkGridLayoutChild

Возвращаемое значение

количество столбцов

gtk_grid_layout_child_set_row_span ()

void
gtk_grid_layout_child_set_row_span (GtkGridLayoutChild *child,
                                    int span);

Устанавливает количество строк, которое child охватывает.

Параметры

child	элемент GtkGridLayoutChild
span	протяжённость `child`

gtk_grid_layout_child_get_row_span ()

int
gtk_grid_layout_child_get_row_span (GtkGridLayoutChild *child);

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

Параметры

child

элемент GtkGridLayoutChild

Возвращаемое значение

количество строк

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

GtkGridLayout

typedef struct _GtkGridLayout GtkGridLayout;

Менеджер компоновки для виджетов в виде сетки.

GtkGridLayoutChild

typedef struct _GtkGridLayoutChild GtkGridLayoutChild;

Свойства компоновки для дочерних элементов GtkGridLayout.

Подробности свойств

Свойство `“baseline-row”`

  “baseline-row”             int

Строка, к которой нужно выровнять по основанию, когда “valign” установлено в GTK_ALIGN_BASELINE.

Владелец: GtkGridLayout

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

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

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

Свойство `“column-homogeneous”`

  “column-homogeneous”       gboolean

Указывает, имеют ли все столбцы в сетке одинаковую ширину.

Владелец: GtkGridLayout

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

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

Свойство `“column-spacing”`

  “column-spacing”           int

Расстояние между двумя смежными столбцами.

Владелец: GtkGridLayout

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

Допустимые значения: [0,32767]

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

Свойство `“row-homogeneous”`

  “row-homogeneous”          gboolean

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

Владелец: GtkGridLayout

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

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

Свойство `“row-spacing”`

  “row-spacing”              int

Расстояние между двумя смежными строками.

Владелец: GtkGridLayout

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

Допустимые значения: [0,32767]

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

Свойство `“column”`

  “column”                   int

Столбец, в котором следует разместить дочерний элемент.

Владелец: GtkGridLayoutChild

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

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

Свойство `“column-span”`

  “column-span”              int

Количество столбцов, которое охватывает дочерний элемент.

Владелец: GtkGridLayoutChild

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

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

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

Свойство `“row”`

  “row”                      int

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

Владелец: GtkGridLayoutChild

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

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

Свойство `“row-span”`

  “row-span”                 int

Количество строк, которое охватывает дочерний элемент.

Владелец: GtkGridLayoutChild

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

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

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

См. также

GtkBoxLayout

© 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/GtkGridLayout.html

GtkGridLayout

Функции

Свойства

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

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

Файлы заголовков

Описание

Функции

gtk_grid_layout_new ()

Возвращает

gtk_grid_layout_set_row_homogeneous ()

Параметры

gtk_grid_layout_get_row_homogeneous ()

Параметры

Возвращает

gtk_grid_layout_set_row_spacing ()

Параметры

gtk_grid_layout_get_row_spacing ()

Параметры

Возвращает

gtk_grid_layout_set_column_homogeneous ()

Параметры

gtk_grid_layout_get_column_homogeneous ()

Параметры

Возвращает

gtk_grid_layout_set_column_spacing ()

Параметры

gtk_grid_layout_get_column_spacing ()

Параметры

Возвращает

gtk_grid_layout_set_row_baseline_position ()

Параметры

gtk_grid_layout_get_row_baseline_position ()

Параметры

Возвращает

gtk_grid_layout_set_baseline_row ()

Параметры

gtk_grid_layout_get_baseline_row ()

Параметры

Возвращает

gtk_grid_layout_child_set_column ()

Параметры

gtk_grid_layout_child_get_column ()

Параметры

Возвращаемое значение

gtk_grid_layout_child_set_row ()

Параметры

gtk_grid_layout_child_get_row ()

Параметры

Возвращаемое значение

gtk_grid_layout_child_set_column_span ()

Параметры

gtk_grid_layout_child_get_column_span ()

Параметры

Возвращаемое значение

gtk_grid_layout_child_set_row_span ()

Параметры

gtk_grid_layout_child_get_row_span ()

Параметры

Возвращаемое значение

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

GtkGridLayout

GtkGridLayoutChild

Подробности свойств

Свойство “baseline-row”

Свойство “column-homogeneous”

Свойство “column-spacing”

Свойство “row-homogeneous”

Свойство “row-spacing”

Свойство “column”

Свойство “column-span”

Свойство “row”

Свойство “row-span”

См. также

Свойство `“baseline-row”`

Свойство `“column-homogeneous”`

Свойство `“column-spacing”`

Свойство `“row-homogeneous”`

Свойство `“row-spacing”`

Свойство `“column”`

Свойство `“column-span”`

Свойство `“row”`

Свойство `“row-span”`