Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties

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