GTK+ Reference Manual |
||||
---|---|---|---|---|
GtkFrameGtkFrame Контейнер с декоративной рамкой и опционально с меткой |
#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().
typedef struct _GtkFrame GtkFrame;
gtk_frame_new ()
GtkWidget* gtk_frame_new (const gchar *label);Создаёт новый GtkFrame, опционально с меткой label. Если label равен NULL, метка неотображается.
label : |
Текст используемый как метка рамки |
Возвращает : |
Новый виджет GtkFrame |
void gtk_frame_set_label (GtkFrame *frame,
const gchar *label);
Устанавливает текст для метки. Если label равен NULL, текущая метка удаляется.
frame : |
|
label : |
Текст используемый как метка рамки |
void gtk_frame_set_label_widget (GtkFrame *frame,
GtkWidget *label_widget);
Устанавливает виджет ярлык для рамки. Этот виджет будет казаться внедрённым в верхнюю кромку рамки как заголовок.
frame : |
|
label_widget : |
Новый виджет ярлык |
void gtk_frame_set_label_align (GtkFrame *frame,
gfloat xalign,
gfloat yalign);
Устанавливает выравнивание виджета ярлык в рамке. Значения по умолчанию для вновь созданной рамки 0.0 и 0.5.
frame : |
|
xalign : |
Позиция метки по верхнему краю виджета. Значение 0.0 представляет левое выравнивание; 1.0 представляет правое выравнивание. |
yalign : |
Выравнивание метки. Значение 0.0 выравнивает под рамкой; 1.0 выравнивает над рамкой. |
void gtk_frame_set_shadow_type (GtkFrame *frame,
GtkShadowType type);
Устанавливает тип тени для frame.
frame : |
|
type : |
новый GtkShadowType |
const gchar* gtk_frame_get_label (GtkFrame *frame);Если ярлык виджет рамки это GtkLabel, возвращает текст в виджет ярлык. (Рамка будет иметь GtkLabel для виджета ярлыка, если не-NULL параметр был передан в gtk_frame_new().)
frame : |
|
Возвращает : |
Текст ярлыка, или NULL если не было виджета ярлыка или виджет ярлык был не GtkLabel. Этой строкой владеет GTK+ и не нужно её изменять или освобождать. |
void gtk_frame_get_label_align (GtkFrame *frame,
gfloat *xalign,
gfloat *yalign);
Восстанавливает выравнивание по X и Y метки рамки. Смотрите gtk_frame_set_label_align().
frame : |
|
xalign : |
Размещение сохраняемого значения X выравнивания метки рамки, или NULL |
yalign : |
Размещение сохраняемого значения Y выравнивания метки рамки, или NULL |
GtkWidget* gtk_frame_get_label_widget (GtkFrame *frame);Восстанавливает виджет ярлык для рамки. Смотрите gtk_frame_set_label_widget().
frame : |
|
Возвращает : |
Виджет ярлык, или NULL если нет. |
GtkShadowType gtk_frame_get_shadow_type (GtkFrame *frame);Восстанавливает тип тени рамки. Смотрите gtk_frame_set_shadow_type().
frame : |
|
Возвращает : |
Текущий тип тени рамки. |
"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