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

#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 устарела и не должна использоваться во вновь создаваемом коде.

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

gtk_button_box_get_layout ()

gtkbuttonboxstyle gtk_button_box_get_layout (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 являются полями которые заполняются этими значениями, соответственно.

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".

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

gtk_button_box_get_child_secondary ()

gboolean    gtk_button_box_get_child_secondary
                                            (gtkbuttonbox *widget,
                                             gtkwidget *child);

определяет должен ли 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 устарела и не должна использоваться во вновь создаваемом коде.

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

gtk_button_box_set_layout ()

void        gtk_button_box_set_layout       (gtkbuttonbox *widget,
                                             gtkbuttonboxstyle 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".

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

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".

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

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, то вторичные дочерние виджеты выравниваются с другого конца контейнера кнопок относительно основных кнопок. для других стилей, они появляются непосредственно рядом с основными дочерними кнопками.

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

свойство "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

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