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

layout-style

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

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

gboolean	non-homogeneous	Чтение/Запись
gboolean	secondary	Чтение/Запись

Стилизованные свойства

gint	child-internal-pad-x	Чтение
gint	child-internal-pad-y	Чтение
gint	child-min-height	Чтение
gint	child-min-width	Чтение

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

struct	GtkButtonBox
struct	GtkButtonBoxClass
enum	GtkButtonBoxStyle

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

    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.

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

Значение по умолчанию: 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.20/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”`