| Top |  |
 |
 |
 |
Object Hierarchy
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkFrame ╰── GtkAspectFrame
Description
The GtkAspectFrame is useful when you want pack a widget so that it can resize but always retains the same aspect ratio. For instance, one might be drawing a small preview of a larger image. GtkAspectFrame derives from GtkFrame, so it can draw a label and a frame around the child. The frame will be "shrink-wrapped" to the size of the child.
Functions
gtk_aspect_frame_new ()
GtkWidget * gtk_aspect_frame_new (const gchar *label,gfloat xalign,gfloat yalign,gfloat ratio,gboolean obey_child);
Create a new GtkAspectFrame.
Parameters
label |
Label text. |
|
xalign |
Horizontal alignment of the child within the allocation of the GtkAspectFrame. This ranges from 0.0 (left aligned) to 1.0 (right aligned) |
|
yalign |
Vertical alignment of the child within the allocation of the GtkAspectFrame. This ranges from 0.0 (left aligned) to 1.0 (right aligned) |
|
ratio |
The desired aspect ratio. |
|
obey_child |
If |
gtk_aspect_frame_set ()
void gtk_aspect_frame_set (GtkAspectFrame *aspect_frame,gfloat xalign,gfloat yalign,gfloat ratio,gboolean obey_child);
Set parameters for an existing GtkAspectFrame.
Parameters
aspect_frame |
||
xalign |
Horizontal alignment of the child within the allocation of the GtkAspectFrame. This ranges from 0.0 (left aligned) to 1.0 (right aligned) |
|
yalign |
Vertical alignment of the child within the allocation of the GtkAspectFrame. This ranges from 0.0 (left aligned) to 1.0 (right aligned) |
|
ratio |
The desired aspect ratio. |
|
obey_child |
If |
Property Details
The “obey-child” property
“obey-child” gboolean
Force aspect ratio to match that of the frame's child.
Flags: Read / Write
Default value: TRUE
The “ratio” property
“ratio” gfloat
Aspect ratio if obey_child is FALSE.
Flags: Read / Write
Allowed values: [0.0001,10000]
Default value: 1
The “xalign” property
“xalign” gfloat
X alignment of the child.
Flags: Read / Write
Allowed values: [0,1]
Default value: 0.5
The “yalign” property
“yalign” gfloat
Y alignment of the child.
Flags: Read / Write
Allowed values: [0,1]
Default value: 0.5