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	вторичный	Чтение / Запись

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

gint	внутренний-отступ-x	Чтение
gint	внутренний-отступ-y	Чтение
gint	минимальная-высота	Чтение
gint	минимальная-ширина	Чтение

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

struct	GtkButtonBox
struct	GtkButtonBoxClass
enum	GtkButtonBoxStyle

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

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

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

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

Файлы

#include <gtk/gtk.h>

Описание

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

gtk_button_box_get_layout() и gtk_button_box_set_layout() соответственно извлекают и изменяют метод, используемый для распределения кнопок в контейнере GtkButtonBox.

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

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

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

a GtkButtonBox

Возвращает

метод, используемый для размещения кнопок в widget .

gtk_button_box_get_child_secondary ()

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

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

Параметры

widget	a 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	a GtkButtonBox
child	дочерний элемент `widget`

Возвращает

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

С: 3.2

gtk_button_box_set_layout ()

void
gtk_button_box_set_layout (GtkButtonBox *widget,
                           GtkButtonBoxStyle layout_style);

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

Параметры

widget	a 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	a 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	a 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.

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

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

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

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

  “non-homogeneous”          gboolean

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

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

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

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

  “secondary”                gboolean

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

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

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

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

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

  “child-internal-pad-x”     gint

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

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

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

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

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

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

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

  “child-internal-pad-y”     gint

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

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

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

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

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

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

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

  “child-min-height”         gint

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

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

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

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

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

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

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

  “child-min-width”          gint

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

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

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

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

Допустимые значения: >= 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.22/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”`