GtkButtonBox

GtkButtonBox — Контейнер для размещения кнопок

Функции

GtkWidget *	gtk_button_box_new ()
GtkButtonBoxStyle	gtk_button_box_get_layout ()
gboolean	gtk_button_box_get_child_secondary ()
gboolean	gtk_button_box_get_child_non_homogeneous ()
void	gtk_button_box_set_layout ()
void	gtk_button_box_set_child_secondary ()
void	gtk_button_box_set_child_non_homogeneous ()

Свойства

GtkButtonBoxStyle

стиль-размещения

Чтение / Запись

Свойства дочерних элементов

gboolean	не-однородный	Чтение / Запись
gboolean	вспомогательный	Чтение / Запись

Свойства стиля

int	внутренний отступ по X	Чтение
int	внутренний отступ по Y	Чтение
int	минимальная высота элемента	Чтение
int	минимальная ширина элемента	Чтение

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

struct	GtkButtonBox
struct	GtkButtonBoxClass
enum	СтильGtkButtonBox

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBox
                    ╰── GtkButtonBox
                        ├── GtkHButtonBox
                        ╰── GtkVButtonBox

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

GtkButtonBox реализует AtkImplementorIface, GtkBuildable и GtkOrientable.

Включенные заголовочные файлы

#include <gtk/gtk.h>

Описание

Блок кнопок должен использоваться для обеспечения согласованного расположения кнопок во всем вашем приложении. Размещение/интервалы могут быть изменены программистом, или, при необходимости, пользователем, для изменения «ощущений» программы в небольшой степени.

Функции gtk_button_box_get_layout() и gtk_button_box_set_layout() соответственно извлекают и изменяют метод распределения кнопок в блоке кнопок по контейнеру.

Основная цель GtkButtonBox — убедиться, что у всех дочерних элементов одинаковый размер. GtkButtonBox присваивает всем дочерним элементам одинаковый размер, но позволяет «исключениям» сохранять свой собственный больший размер.

Чтобы исключить отдельные дочерние элементы из однородного изменения размеров независимо от их статуса «исключений», можно установить свойство non-homogeneous дочернего элемента.

CSS-узлы

GtkButtonBox использует один CSS-узел с именем buttonbox.

Функции

gtk_button_box_new ()

GtkWidget *
gtk_button_box_new (GtkOrientation orientation);

Создаёт новую GtkButtonBox.

Параметры

orientation

ориентация рамки.

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

новая GtkButtonBox.

С версии: 3.0

gtk_button_box_get_layout ()

GtkButtonBoxStyle
gtk_button_box_get_layout (GtkButtonBox *widget);

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

Параметры

widget

GtkButtonBox

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

способ расположения кнопок в widget .

gtk_button_box_get_child_secondary ()

gboolean
gtk_button_box_get_child_secondary (GtkButtonBox *widget,
                                    GtkWidget *child);

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

Параметры

widget	GtkButtonBox
child	элемент `widget`

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

будет ли child отображаться во вторичной группе элементов.

С версии: 2.4

gtk_button_box_get_child_non_homogeneous ()

gboolean
gtk_button_box_get_child_non_homogeneous
                               (GtkButtonBox *widget,
                                GtkWidget *child);

Возвращает, освобождён ли элемент от однородного размера.

Параметры

widget	GtkButtonBox
child	элемент `widget`

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

TRUE если элемент не подчиняется однородному размеру.

С версии: 3.2

gtk_button_box_set_layout ()

void
gtk_button_box_set_layout (GtkButtonBox *widget,
                           GtkButtonBoxStyle layout_style);

Изменяет способ расположения кнопок в контейнере.

Параметры

widget	GtkButtonBox
layout_style	новый стиль расположения

gtk_button_box_set_child_secondary ()

void
gtk_button_box_set_child_secondary (GtkButtonBox *widget,
                                    GtkWidget *child,
                                    gboolean is_secondary);

Устанавливает, будет ли child отображаться во вторичной группе элементов. Пример использования — кнопка справки в диалоговом окне.

Эта группа отображается после других элементов, если стиль — GTK_BUTTONBOX_START, GTK_BUTTONBOX_SPREAD или GTK_BUTTONBOX_EDGE, и перед другими элементами, если стиль — GTK_BUTTONBOX_END. Для горизонтальных рамок, определение «перед/после» зависит от направления виджета (см. gtk_widget_set_direction()). Если стиль — GTK_BUTTONBOX_START или GTK_BUTTONBOX_END, вторичные элементы выравниваются на другом конце рамки, в отличие от основных элементов. В других случаях они отображаются непосредственно рядом с основными элементами.

Параметры

widget	GtkButtonBox
child	элемент `widget`
is_secondary	если `TRUE`, `child` отображается во вторичной группе.

gtk_button_box_set_child_non_homogeneous ()

void
gtk_button_box_set_child_non_homogeneous
                               (GtkButtonBox *widget,
                                GtkWidget *child,
                                gboolean non_homogeneous);

Устанавливает, освобождён ли элемент от однородного размера.

Параметры

widget	GtkButtonBox
child	элемент `widget`
non_homogeneous	новое значение

С версии: 3.2

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

struct GtkButtonBox

struct GtkButtonBox;

struct GtkButtonBoxClass

struct GtkButtonBoxClass {
  GtkBoxClass parent_class;
};

Члены

перечисление GtkButtonBoxStyle

Определяет стиль расположения кнопок в GtkButtonBox.

Члены

GTK_BUTTONBOX_SPREAD	Кнопки равномерно распределены в рамке.
GTK_BUTTONBOX_EDGE	Кнопки размещаются по краям рамки.
GTK_BUTTONBOX_START	Кнопки сгруппированы в начале рамки (слева для HBox, сверху для VBox).
GTK_BUTTONBOX_END	Кнопки сгруппированы в конце рамки (справа для HBox, снизу для VBox).
GTK_BUTTONBOX_CENTER	Кнопки центрированы в рамке. С версии 2.12.
GTK_BUTTONBOX_EXPAND	Кнопки занимают всё пространство рамки. Это означает, что кнопки имеют «связанный» вид, размеры кнопок однородны, а отступы равны 0 (как при ручном вызове `gtk_box_set_homogeneous()` и `gtk_box_set_spacing()`). С версии 3.12.

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

Свойство `“layout-style”`

  “layout-style”             GtkButtonBoxStyle

Способ расположения кнопок в рамке. Возможные значения: spread, edge, start и end.

Владелец: GtkButtonBox

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

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

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

Свойство `“non-homogeneous”` элемента

  “non-homogeneous”          gboolean

Если TRUE, элемент не подчиняется однородному размеру.

Владелец: GtkButtonBox

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

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

Свойство `“secondary”` элемента

  “secondary”                gboolean

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

Владелец: GtkButtonBox

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

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

Подробные сведения о свойствах стиля

Свойство стиля `“child-internal-pad-x”`

  “child-internal-pad-x”     int

Значение, на которое увеличивается размер элемента с каждой стороны.

GtkButtonBox:child-internal-pad-x устарело начиная с версии 3.20 и не должно использоваться в новых кодах.

Используйте CSS-свойство padding вместо этого.

Владелец: GtkButtonBox

Флаги: Чтение

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

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

Свойство стиля `“child-internal-pad-y”`

  “child-internal-pad-y”     int

Значение, на которое увеличивается размер элемента сверху и снизу.

GtkButtonBox:child-internal-pad-y устарело начиная с версии 3.20 и не должно использоваться в новых кодах.

Используйте CSS-свойство padding вместо этого.

Владелец: GtkButtonBox

Флаги: Чтение

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

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

Свойство стиля `“child-min-height”`

  “child-min-height”         int

Минимальная высота кнопок внутри контейнера.

GtkButtonBox:child-min-height устарело начиная с версии 3.20 и не должно использоваться в новых кодах.

Используйте CSS-свойство min-height вместо этого.

Владелец: GtkButtonBox

Флаги: Чтение

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

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

Свойство стиля `“child-min-width”`

  “child-min-width”          int

Минимальная ширина кнопок внутри контейнера.

GtkButtonBox:child-min-width устарело начиная с версии 3.20 и не должно использоваться в новых кодах.

Используйте CSS-свойство min-width вместо этого.

Владелец: GtkButtonBox

Флаги: Чтение

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

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

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/GtkButtonBox.html

GtkButtonBox

Функции

Свойства

Свойства дочерних элементов

Свойства стиля

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

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

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

Включенные заголовочные файлы

Описание

CSS-узлы

Функции

gtk_button_box_new ()

Параметры

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

gtk_button_box_get_layout ()

Параметры

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

gtk_button_box_get_child_secondary ()

Параметры

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

gtk_button_box_get_child_non_homogeneous ()

Параметры

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

gtk_button_box_set_layout ()

Параметры

gtk_button_box_set_child_secondary ()

Параметры

gtk_button_box_set_child_non_homogeneous ()

Параметры

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

struct GtkButtonBox

struct GtkButtonBoxClass

Члены

перечисление GtkButtonBoxStyle

Члены

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

Свойство “layout-style”

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

Свойство “non-homogeneous” элемента

Свойство “secondary” элемента

Подробные сведения о свойствах стиля

Свойство стиля “child-internal-pad-x”

Свойство стиля “child-internal-pad-y”

Свойство стиля “child-min-height”

Свойство стиля “child-min-width”

Свойство `“layout-style”`

Свойство `“non-homogeneous”` элемента

Свойство `“secondary”` элемента

Свойство стиля `“child-internal-pad-x”`

Свойство стиля `“child-internal-pad-y”`

Свойство стиля `“child-min-height”`

Свойство стиля `“child-min-width”`