Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties

GtkAspectFrame

GtkAspectFrame Рамка вынуждающая дочерний виджет к специфическому соотношению сторон

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

#include <gtk/gtk.h> GtkAspectFrame; GtkWidget* gtk_aspect_frame_new (const gchar *label, gfloat xalign, gfloat yalign, gfloat ratio, gboolean obey_child); void gtk_aspect_frame_set (GtkAspectFrame *aspect_frame, gfloat xalign, gfloat yalign, gfloat ratio, gboolean obey_child);

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

GObject +----GInitiallyUnowned +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkFrame +----GtkAspectFrame

Осуществляемые интерфейсы

GtkAspectFrame осуществляет AtkImplementorIface.

Свойства

"obey-child" gboolean : Read / Write "ratio" gfloat : Read / Write "xalign" gfloat : Read / Write "yalign" gfloat : Read / Write

Описание

GtkAspectFrame полезна когда вам необходимо упаковать виджет, который бы мог изменять размер, но при этом всегда сохранял соотношение сторон. Например, небольшой эскиз для предварительного просмотра большого изображения. GtkAspectFrame происходит из GtkFrame, поэтому она может отрисовывать метку и рамку вокруг дочернего виджета. Рамка будет упакована ("shrink-wrapped") к размеру дочернего виджета.

Детали

GtkAspectFrame

typedef struct _GtkAspectFrame GtkAspectFrame;

gtk_aspect_frame_new ()

GtkWidget* gtk_aspect_frame_new (const gchar *label, gfloat xalign, gfloat yalign, gfloat ratio, gboolean obey_child);

Создаёт новый GtkAspectFrame.

label :

Текстовая метка.

xalign :

Горизонтальное выравнивание дочернего виджета в пределах распределённых GtkAspectFrame. Диапазон от 0.0 (левое выравнивание) до 1.0 (правое выравнивание)

yalign :

Вертикальное выравнивание дочернего виджета в пределах распределённых GtkAspectFrame. Диапазон от 0.0 (левое выравнивание) до 1.0 (правое выравнивание)

ratio :

Желаемое соотношение сторон.

obey_child :

Если TRUE, ratio игнорируется, а соотношение сторон берётся из реквизиции дочернего виджета.

Возвращает :

новый GtkAspectFrame.


gtk_aspect_frame_set ()

void gtk_aspect_frame_set (GtkAspectFrame *aspect_frame, gfloat xalign, gfloat yalign, gfloat ratio, gboolean obey_child);

Устанавливает параметры существующей GtkAspectFrame.

aspect_frame :

GtkAspectFrame

xalign :

Горизонтальное выравнивание дочернего виджета в пределах распределённых GtkAspectFrame. Диапазон от 0.0 (левое выравнивание) до 1.0 (правое выравнивание)

yalign :

Вертикальное выравнивание дочернего виджета в пределах распределённых GtkAspectFrame. Диапазон от 0.0 (левое выравнивание) до 1.0 (правое выравнивание)

ratio :

Желаемое соотношение сторон.

obey_child :

Если TRUE, ratio игнорируется, а соотношение сторон берётся из реквизиции дочернего виджета.

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

Свойство "obey-child"

  "obey-child"           gboolean              : Read / Write

Вынуждаемое соотношение сторон для соответствия дочернему виджету рамки.

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


Свойство "ratio"

  "ratio"                gfloat                : Read / Write

Соотношение сторон если obey_child равен FALSE.

Допустимые значения: [1e-04,10000]

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


Свойство "xalign"

  "xalign"               gfloat                : Read / Write

X выравнивание дочернего виджета.

Допустимые значения: [0,1]

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


Свойство "yalign"

  "yalign"               gfloat                : Read / Write

Y выравнивание дочернего виджета.

Допустимые значения: [0,1]

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