Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Implemented Interfaces  |  Properties  |  Child Properties  |  Style Properties

GtkButtonBox

GtkButtonBox Базовый класс для GtkHButtonBox и GtkVButtonBox

Краткое описание

#include <gtk/gtk.h> GtkButtonBox; #define GTK_BUTTONBOX_DEFAULT #define gtk_button_box_get_spacing (b) GtkButtonBoxStyle gtk_button_box_get_layout (GtkButtonBox *widget); void gtk_button_box_get_child_size (GtkButtonBox *widget, gint *min_width, gint *min_height); void gtk_button_box_get_child_ipadding (GtkButtonBox *widget, gint *ipad_x, gint *ipad_y); gboolean gtk_button_box_get_child_secondary (GtkButtonBox *widget, GtkWidget *child); #define gtk_button_box_set_spacing (b,s) void gtk_button_box_set_layout (GtkButtonBox *widget, GtkButtonBoxStyle layout_style); void gtk_button_box_set_child_size (GtkButtonBox *widget, gint min_width, gint min_height); void gtk_button_box_set_child_ipadding (GtkButtonBox *widget, gint ipad_x, gint ipad_y); void gtk_button_box_set_child_secondary (GtkButtonBox *widget, GtkWidget *child, gboolean is_secondary);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBox +----GtkButtonBox +----GtkHButtonBox +----GtkVButtonBox

Реализуемые интерфейсы

GtkButtonBox реализует AtkImplementorIface.

Свойства

"layout-style" GtkButtonBoxStyle : Read / Write

Дочерние свойства

"secondary" gboolean : Read / Write

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

"child-internal-pad-x" gint : Read "child-internal-pad-y" gint : Read "child-min-height" gint : Read "child-min-width" gint : Read

Описание

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

gtk_button_box_get_child_size() определяет минимальную высоту и ширину виджетов в полученном контейнере кнопок. gtk_button_box_set_child_size() позволяет изменять эти свойства.

Внутреннее дополнение кнопок может быть определено и изменено с помощью gtk_button_box_get_child_ipadding() и gtk_button_box_set_child_ipadding() соответственно.

gtk_button_box_get_spacing() и gtk_button_box_set_spacing() определяет и изменяет интервал между кнопками соответственно.

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

Основная цель GtkButtonBox заставить все дочерние кнопки иметь одинаковый размер. Поэтому он игнорирует свойство однородности (homogeneous) которое он унаследовал от GtkBox, и всегда ведёт себя как если бы свойство однородности имело значение TRUE.

Детали

GtkButtonBox

typedef struct _GtkButtonBox GtkButtonBox;

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


GTK_BUTTONBOX_DEFAULT

#define GTK_BUTTONBOX_DEFAULT -1

Только для внутреннего использования.


gtk_button_box_get_spacing()

#define gtk_button_box_get_spacing(b)   gtk_box_get_spacing (GTK_BOX (b))

Внимание

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

Определяет интервал между кнопками.

b :

GtkButtonBox

Возвращает:

Текущий интервал между кнопками в widget.


gtk_button_box_get_layout ()

GtkButtonBoxStyle gtk_button_box_get_layout (GtkButtonBox *widget);

Определяет метод выравнивания кнопок в контейнере.

widget :

GtkButtonBox.

Возвращает:

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


gtk_button_box_get_child_size ()

void gtk_button_box_get_child_size (GtkButtonBox *widget, gint *min_width, gint *min_height);

Внимание

gtk_button_box_get_child_size устарела и не должна использоваться во вновь создаваемом коде. Вместо неё используйте свойство стиля "child-min-width/-height".

Определяет текущую ширину и высоту всех дочерних виджетов в контейнере кнопок. min_width и min_height являются полями которые заполняются этими значениями, соответственно.

widget :

GtkButtonBox.

min_width :

Ширина кнопок содержащихся в widget.

min_height :

Высота кнопок содержащихся в widget.


gtk_button_box_get_child_ipadding ()

void gtk_button_box_get_child_ipadding (GtkButtonBox *widget, gint *ipad_x, gint *ipad_y);

Внимание

gtk_button_box_get_child_ipadding устарела и не должна использоваться во вновь создаваемом коде. Используйте вместо неё свойство стиля "child-internal-pad-x/-y".

Определяет количество пикселей по умолчанию, дополняющих кнопки в полученном контейнере кнопок.

widget :

GtkButtonBox.

ipad_x :

Горизонтальное дополнение используемое кнопками в widget.

ipad_y :

Вертикальное дополнение используемое кнопками в 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_set_spacing()

#define gtk_button_box_set_spacing(b,s) gtk_box_set_spacing (GTK_BOX (b), s)

Внимание

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

Устанавливает интервал между кнопок в полученном контейнере кнопок.

b :

GtkButtonBox.

s :

Интервал в пикселах.


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_size ()

void gtk_button_box_set_child_size (GtkButtonBox *widget, gint min_width, gint min_height);

Внимание

gtk_button_box_set_child_size устарела и не должна использоваться во вновь создаваемом коде. Вместо неё используйте свойство стиля "child-min-width/-height".

Устанавливает новый размер по умолчанию для дочерних виджетов полученного контейнера кнопок.

widget :

GtkButtonBox.

min_width :

Ширина по умолчанию для кнопок в widget.

min_height :

Высота по умолчанию для кнопок в widget.


gtk_button_box_set_child_ipadding ()

void gtk_button_box_set_child_ipadding (GtkButtonBox *widget, gint ipad_x, gint ipad_y);

Внимание

gtk_button_box_set_child_ipadding устарела и не должна использоваться во вновь создаваемом коде. Вместо неё используйте свойство стиля "child-internal-pad-x/-y".

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

widget :

GtkButtonBox.

ipad_x :

Горизонтальное дополнение которое должно использоваться каждой кнопкой в widget.

ipad_y :

Вертикальное дополнение которое должно использоваться каждой кнопкой в widget.


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 появится во вторичной группе контейнера кнопок.

Детали свойств

Свойство "layout-style"

  "layout-style"         GtkButtonBoxStyle     : Read / Write

Как выравнивать кнопки в контейнере. Возможные значения default, spread, edge, start и end.

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

Детали дочерних свойств

Дочернее свойство "secondary"

  "secondary"            gboolean              : Read / Write

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

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

Детали свойств стиля

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

  "child-internal-pad-x" gint                  : Read

Увеличение размера дочернего виджета с обеих сторон.

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

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


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

  "child-internal-pad-y" gint                  : Read

Уменьшение размера дочернего виджета сверху и снизу.

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

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


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

  "child-min-height"     gint                  : Read

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

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

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


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

  "child-min-width"      gint                  : Read

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

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

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

Смотрите также

GtkVButtonBox

Вертикальный подкласс GtkButtonBox.

GtkHButtonBox

Горизонтальный подкласс GtkButtonBox.