Prev

Up

Home

GTK+ Reference Manual

Next

Top  |  Description  |  Object Hierarchy  |  Properties

GtkFrame

GtkFrame Контейнер с декоративной рамкой и опционально с меткой

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

#include <gtk/gtk.h> GtkFrame; GtkWidget* gtk_frame_new (const gchar *label); void gtk_frame_set_label (GtkFrame *frame, const gchar *label); void gtk_frame_set_label_widget (GtkFrame *frame, GtkWidget *label_widget); void gtk_frame_set_label_align (GtkFrame *frame, gfloat xalign, gfloat yalign); void gtk_frame_set_shadow_type (GtkFrame *frame, GtkShadowType type); const gchar* gtk_frame_get_label (GtkFrame *frame); void gtk_frame_get_label_align (GtkFrame *frame, gfloat *xalign, gfloat *yalign); GtkWidget* gtk_frame_get_label_widget (GtkFrame *frame); GtkShadowType gtk_frame_get_shadow_type (GtkFrame *frame);

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

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

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

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

Свойства

"label" gchararray : Read / Write "label-widget" GtkWidget : Read / Write "label-xalign" gfloat : Read / Write "label-yalign" gfloat : Read / Write "shadow" GtkShadowType : Read / Write "shadow-type" GtkShadowType : Read / Write

Описание

Виджет рамка это контейнер окружающий свой дочерний виджет рамкой с опционально дополненной меткой. Метка отображается, если установлена, в верхнем промежутке рамки. Позицией метки можно управлять с помощью gtk_frame_set_label_align().

Детали

GtkFrame

typedef struct _GtkFrame GtkFrame;

gtk_frame_new ()

GtkWidget*  gtk_frame_new                   (const gchar *label);

Создаёт новый GtkFrame, опционально с меткой label. Если label равен NULL, метка неотображается.

label :

Текст используемый как метка рамки

Возвращает :

Новый виджет GtkFrame


gtk_frame_set_label ()

void gtk_frame_set_label (GtkFrame *frame, const gchar *label);

Устанавливает текст для метки. Если label равен NULL, текущая метка удаляется.

frame :

GtkFrame

label :

Текст используемый как метка рамки


gtk_frame_set_label_widget ()

void gtk_frame_set_label_widget (GtkFrame *frame, GtkWidget *label_widget);

Устанавливает виджет ярлык для рамки. Этот виджет будет казаться внедрённым в верхнюю кромку рамки как заголовок.

frame :

GtkFrame

label_widget :

Новый виджет ярлык


gtk_frame_set_label_align ()

void gtk_frame_set_label_align (GtkFrame *frame, gfloat xalign, gfloat yalign);

Устанавливает выравнивание виджета ярлык в рамке. Значения по умолчанию для вновь созданной рамки 0.0 и 0.5.

frame :

GtkFrame

xalign :

Позиция метки по верхнему краю виджета. Значение 0.0 представляет левое выравнивание; 1.0 представляет правое выравнивание.

yalign :

Выравнивание метки. Значение 0.0 выравнивает под рамкой; 1.0 выравнивает над рамкой.


gtk_frame_set_shadow_type ()

void gtk_frame_set_shadow_type (GtkFrame *frame, GtkShadowType type);

Устанавливает тип тени для frame.

frame :

GtkFrame

type :

новый GtkShadowType


gtk_frame_get_label ()

const gchar* gtk_frame_get_label            (GtkFrame *frame);

Если ярлык виджет рамки это GtkLabel, возвращает текст в виджет ярлык. (Рамка будет иметь GtkLabel для виджета ярлыка, если не-NULL параметр был передан в gtk_frame_new().)

frame :

GtkFrame

Возвращает :

Текст ярлыка, или NULL если не было виджета ярлыка или виджет ярлык был не GtkLabel. Этой строкой владеет GTK+ и не нужно её изменять или освобождать.


gtk_frame_get_label_align ()

void gtk_frame_get_label_align (GtkFrame *frame, gfloat *xalign, gfloat *yalign);

Восстанавливает выравнивание по X и Y метки рамки. Смотрите gtk_frame_set_label_align().

frame :

GtkFrame

xalign :

Размещение сохраняемого значения X выравнивания метки рамки, или NULL

yalign :

Размещение сохраняемого значения Y выравнивания метки рамки, или NULL


gtk_frame_get_label_widget ()

GtkWidget*  gtk_frame_get_label_widget      (GtkFrame *frame);

Восстанавливает виджет ярлык для рамки. Смотрите gtk_frame_set_label_widget().

frame :

GtkFrame

Возвращает :

Виджет ярлык, или NULL если нет.


gtk_frame_get_shadow_type ()

GtkShadowType gtk_frame_get_shadow_type     (GtkFrame *frame);

Восстанавливает тип тени рамки. Смотрите gtk_frame_set_shadow_type().

frame :

GtkFrame

Возвращает :

Текущий тип тени рамки.

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

Свойство "label"

  "label"                gchararray            : Read / Write

Текст метки рамки.

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


Свойство "label-widget"

  "label-widget"         GtkWidget             : Read / Write

Виджет отображаемый вместо обычной метки рамки.


Свойство "label-xalign"

  "label-xalign"         gfloat                : Read / Write

Горизонтальное выравнивание метки.

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

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


Свойство "label-yalign"

  "label-yalign"         gfloat                : Read / Write

Вертикальное выравнивание метки.

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

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


Свойство "shadow"

  "shadow"               GtkShadowType         : Read / Write

Устаревшее свойство, используйте вместо него shadow_type.

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


Свойство "shadow-type"

  "shadow-type"          GtkShadowType         : Read / Write

Внешний вид бордюра рамки.

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