| Top | |
|
|
|
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkFrame ╰── GtkAspectFrame
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.
GtkWidget * gtk_aspect_frame_new (const gchar *label,gfloat xalign,gfloat yalign,gfloat ratio,gboolean obey_child);
Create a new GtkAspectFrame.
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 |
void gtk_aspect_frame_set (GtkAspectFrame *aspect_frame,gfloat xalign,gfloat yalign,gfloat ratio,gboolean obey_child);
Set parameters for an existing GtkAspectFrame.
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 |
“obey-child” property“obey-child” gboolean
Force aspect ratio to match that of the frame's child.
Flags: Read / Write
Default value: TRUE
“ratio” property“ratio” gfloat
Aspect ratio if obey_child is FALSE.
Flags: Read / Write
Allowed values: [0.0001,10000]
Default value: 1
“xalign” property“xalign” gfloat
X alignment of the child.
Flags: Read / Write
Allowed values: [0,1]
Default value: 0.5
“yalign” property“yalign” gfloat
Y alignment of the child.
Flags: Read / Write
Allowed values: [0,1]
Default value: 0.5