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

#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, метка неотображается.

gtk_frame_set_label ()

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

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

gtk_frame_set_label_widget ()

void        gtk_frame_set_label_widget      (gtkframe *frame,
                                             gtkwidget *label_widget);

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

gtk_frame_set_label_align ()

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

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

gtk_frame_set_shadow_type ()

void        gtk_frame_set_shadow_type       (gtkframe *frame,
                                             gtkshadowtype type);

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

gtk_frame_get_label ()

const gchar* gtk_frame_get_label            (gtkframe *frame);

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

gtk_frame_get_label_align ()

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

восстанавливает выравнивание по x и y метки рамки. смотрите gtk_frame_set_label_align().

gtk_frame_get_label_widget ()

gtkwidget*  gtk_frame_get_label_widget      (gtkframe *frame);

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

gtk_frame_get_shadow_type ()

gtkshadowtype gtk_frame_get_shadow_type     (gtkframe *frame);

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

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

свойство "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