The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Каталог документации / Раздел "Программирование, языки" / Оглавление документа

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




Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру