gtkalignment
gtkalignment — виджет управляющий размером
и выравниванием своего дочернего
виджета
|
|
краткое описание
#include <gtk/gtk.h>
gtkalignment;
gtkwidget* gtk_alignment_new (gfloat xalign,
gfloat yalign,
gfloat xscale,
gfloat yscale);
void gtk_alignment_set (gtkalignment *alignment,
gfloat xalign,
gfloat yalign,
gfloat xscale,
gfloat yscale);
void gtk_alignment_get_padding (gtkalignment *alignment,
guint *padding_top,
guint *padding_bottom,
guint *padding_left,
guint *padding_right);
void gtk_alignment_set_padding (gtkalignment *alignment,
guint padding_top,
guint padding_bottom,
guint padding_left,
guint padding_right);
иерархия объектов
gobject
+----ginitiallyunowned
+----gtkobject
+----gtkwidget
+----gtkcontainer
+----gtkbin
+----gtkalignment
осуществляемый интерфейс
gtkalignment осуществляет atkimplementoriface.
свойства
"bottom-padding" guint : read / write
"left-padding" guint : read / write
"right-padding" guint : read / write
"top-padding" guint : read / write
"xalign" gfloat : read / write
"xscale" gfloat : read / write
"yalign" gfloat : read / write
"yscale" gfloat : read / write
описание
виджет gtkalignment контролирует
размер и выравнивание своего дочернего
виджета. он имеет четыре настройки:
xscale, yscale, xalign, и yalign.
настройки масштаба применяются для
определения того, насколько дочерний
виджет может расширяться в рамках
распределённого пространства gtkalignment.
диапазон значений от 0 (дочерний виджет
вообще не расширяется) до 1 (дочерний
виджет заполняет всё доступное
пространство).
настройки выравнивания используются
для размещения дочернего виджета в
пределах доступного пространства.
диапазон значений от 0 (вверху или слева)
до 1 (внизу или справа). естественно, если
настройки масштабирования установлены
в значение равное 1, настройки выравнивания
не имеют никакого эффекта.
детали
gtkalignment
typedef struct _gtkalignment gtkalignment;
структура gtkalignment
содержит только закрытые данные, которые
используются функциями приведенными
ниже.
gtk_alignment_new ()
gtkwidget* gtk_alignment_new (gfloat xalign,
gfloat yalign,
gfloat xscale,
gfloat yscale);
создаёт новый gtkalignment.
|
xalign :
|
горизонтальное выравнивание дочернего
виджета от 0 (левое) до 1 (правое)
|
|
yalign :
|
вертикальное выравнивание дочернего
виджета от 0 (верх) до 1 (низ).
|
|
xscale :
|
количество свободного, горизонтального
пространства которое заполняет
дочерний виджет, от 0 до 1. значение 0
запрещает дочернему виджету расширяться.
значение 1 указывает на полное заполнение
пространства распределяемого
gtkalignment.
|
|
yscale :
|
количество свободного пространства
заполняемого дочерним виджетом
вертикально, от 0 до 1. значения аналогичны
xscale.
|
|
возвращает :
|
новый gtkalignment.
|
gtk_alignment_set ()
void gtk_alignment_set (gtkalignment *alignment,
gfloat xalign,
gfloat yalign,
gfloat xscale,
gfloat yscale);
устанавливает gtkalignment значения.
|
alignment :
|
gtkalignment.
|
|
xalign :
|
горизонтальное выравнивание дочернего
виджета от 0 (левое) до 1 (правое)
|
|
yalign :
|
вертикальное выравнивание дочернего
виджета от 0 (верх) до 1 (низ).
|
|
xscale :
|
количество свободного, горизонтального
пространства которое заполняет
дочерний виджет, от 0 до 1. значение 0
запрещает дочернему виджету расширяться.
значение 1 указывает на полное заполнение
пространства распределяемого
gtkalignment.
|
|
yscale :
|
количество свободного пространства
заполняемого дочерним виджетом
вертикально, от 0 до 1. значения аналогичны
xscale.
|
gtk_alignment_get_padding ()
void gtk_alignment_get_padding (gtkalignment *alignment,
guint *padding_top,
guint *padding_bottom,
guint *padding_left,
guint *padding_right);
получает дополнение с разных сторон
виджета. смотрите gtk_alignment_set_padding().
|
alignment :
|
gtkalignment
|
|
padding_top :
|
значение дополнения сверху от
виджета, или null
|
|
padding_bottom :
|
значение дополнения снизу от виджета,
или null
|
|
padding_left :
|
значение дополнения слева от виджета,
или null
|
|
padding_right :
|
значение дополнения справа от
виджета, или null
|
начиная с версии 2.4
gtk_alignment_set_padding ()
void gtk_alignment_set_padding (gtkalignment *alignment,
guint padding_top,
guint padding_bottom,
guint padding_left,
guint padding_right);
устанавливает дополнение с разных
сторон виджета. дополнение добавляет
свободное пространство с разных сторон
виджета. например, используя дополнение
можно выравнивать виджет к противоположной
стороне от дополнения.
|
alignment :
|
gtkalignment
|
|
padding_top :
|
дополнение сверху от виджета
|
|
padding_bottom :
|
дополнение снизу от виджета
|
|
padding_left :
|
дополнение слева от виджета
|
|
padding_right :
|
дополнение справа от виджета
|
начиная с версии 2.4
детали свойств
свойство "bottom-padding"
"bottom-padding" guint : read / write
дополнение вставляемое снизу от виджета.
допустимые значения: <= g_maxint
значение по умолчанию: 0
начиная с версии 2.4
свойство "left-padding"
"left-padding" guint : read / write
дополнение вставляемое слева от виджета.
допустимые значения: <= g_maxint
значение по умолчанию: 0
начиная с версии 2.4
свойство "right-padding"
"right-padding" guint : read / write
дополнение вставляемое справа от
виджета.
допустимые значения: <= g_maxint
значение по умолчанию: 0
начиная с версии 2.4
свойство "top-padding"
"top-padding" guint : read / write
дополнение вставляемое сверху от
виджета.
допустимые значения: <= g_maxint
значение по умолчанию: 0
начиная с версии 2.4
свойство "xalign"
"xalign" gfloat : read / write
горизонтальная позиция дочернего
виджета в доступном пространстве. 0.0
левое выравнивание, 1.0 правое выравнивание.
допустимые значения: [0,1]
значение по умолчанию: 0.5
свойство "xscale"
"xscale" gfloat : read / write
если доступное горизонтальное пространство
больше чем необходимо для дочернего
виджета, сколько из этого пространства
нужно использовать для дочернего
виджета. 0.0 нисколько, 1.0 всё.
допустимые значения: [0,1]
значение по умолчанию: 1
свойство "yalign"
"yalign" gfloat : read / write
вертикальная позиция дочернего виджета
в доступном пространстве. 0.0 верхнее
выравнивание, 1.0 нижнее выравнивание.
допустимые значения: [0,1]
значение по умолчанию: 0.5
свойство "yscale"
"yscale" gfloat : read / write
если доступное вертикальное пространство
больше чем необходимо для дочернего
виджета, сколько из этого пространства
нужно использовать для дочернего
виджета. 0.0 нисколько, 1.0 всё.
допустимые значения: [0,1]
значение по умолчанию: 1
| 
