| Top |  |
 |
 |
 |
Functions
| GtkWidget * | gtk_frame_new () |
| void | gtk_frame_set_label () |
| void | gtk_frame_set_label_widget () |
| void | gtk_frame_set_label_align () |
| void | gtk_frame_set_shadow_type () |
| const gchar * | gtk_frame_get_label () |
| void | gtk_frame_get_label_align () |
| GtkWidget * | gtk_frame_get_label_widget () |
| GtkShadowType | gtk_frame_get_shadow_type () |
Properties
| char * | label | Read / Write |
| GtkWidget * | label-widget | Read / Write |
| float | label-xalign | Read / Write |
| float | label-yalign | Read / Write |
| GtkShadowType | shadow | Read / Write |
| GtkShadowType | shadow-type | Read / Write |
Object Hierarchy
GObject
╰── GInitiallyUnowned
╰── GtkObject
╰── GtkWidget
╰── GtkContainer
╰── GtkBin
╰── GtkFrame
╰── GtkAspectFrame
Functions
gtk_frame_new ()
GtkWidget *
gtk_frame_new (const gchar *label);
Creates a new GtkFrame, with optional label label
.
If label
is NULL, the label is omitted.
gtk_frame_set_label ()
void gtk_frame_set_label (GtkFrame *frame,const gchar *label);
Sets the text of the label. If label
is NULL,
the current label is removed.
gtk_frame_set_label_widget ()
void gtk_frame_set_label_widget (GtkFrame *frame,GtkWidget *label_widget);
Sets the label widget for the frame. This is the widget that will appear embedded in the top edge of the frame as a title.
gtk_frame_set_label_align ()
void gtk_frame_set_label_align (GtkFrame *frame,gfloat xalign,gfloat yalign);
Sets the alignment of the frame widget's label. The default values for a newly created frame are 0.0 and 0.5.
Parameters
frame |
a GtkFrame |
|
xalign |
The position of the label along the top edge of the widget. A value of 0.0 represents left alignment; 1.0 represents right alignment. |
|
yalign |
The y alignment of the label. A value of 0.0 aligns under the frame; 1.0 aligns above the frame. If the values are exactly 0.0 or 1.0 the gap in the frame won't be painted because the label will be completely above or below the frame. |
gtk_frame_set_shadow_type ()
void gtk_frame_set_shadow_type (GtkFrame *frame,GtkShadowType type);
Sets the shadow type for frame
.
gtk_frame_get_label ()
const gchar *
gtk_frame_get_label (GtkFrame *frame);
If the frame's label widget is a GtkLabel, returns the
text in the label widget. (The frame will have a GtkLabel
for the label widget if a non-NULL argument was passed
to gtk_frame_new().)
Returns
the text in the label, or NULL if there
was no label widget or the lable widget was not
a GtkLabel. This string is owned by GTK+ and
must not be modified or freed.
gtk_frame_get_label_align ()
void gtk_frame_get_label_align (GtkFrame *frame,gfloat *xalign,gfloat *yalign);
Retrieves the X and Y alignment of the frame's label. See
gtk_frame_set_label_align().
Parameters
frame |
a GtkFrame |
|
xalign |
location to store X alignment of
frame's label, or |
[out][allow-none] |
yalign |
location to store X alignment of
frame's label, or |
[out][allow-none] |
gtk_frame_get_label_widget ()
GtkWidget *
gtk_frame_get_label_widget (GtkFrame *frame);
Retrieves the label widget for the frame. See
gtk_frame_set_label_widget().
gtk_frame_get_shadow_type ()
GtkShadowType
gtk_frame_get_shadow_type (GtkFrame *frame);
Retrieves the shadow type of the frame. See
gtk_frame_set_shadow_type().
Property Details
The “label” property
“label” char *
Text of the frame's label.
Owner: GtkFrame
Flags: Read / Write
Default value: NULL
The “label-widget” property
“label-widget” GtkWidget *
A widget to display in place of the usual frame label.
Owner: GtkFrame
Flags: Read / Write
The “label-xalign” property
“label-xalign” float
The horizontal alignment of the label.
Owner: GtkFrame
Flags: Read / Write
Allowed values: [0,1]
Default value: 0
The “label-yalign” property
“label-yalign” float
The vertical alignment of the label.
Owner: GtkFrame
Flags: Read / Write
Allowed values: [0,1]
Default value: 0.5
The “shadow” property
“shadow” GtkShadowType
Deprecated property, use shadow_type instead.
Owner: GtkFrame
Flags: Read / Write
Default value: GTK_SHADOW_ETCHED_IN
The “shadow-type” property
“shadow-type” GtkShadowType
Appearance of the frame border.
Owner: GtkFrame
Flags: Read / Write
Default value: GTK_SHADOW_ETCHED_IN