Top |
Functions
GtkWidget * | gtk_aspect_frame_new () |
void | gtk_aspect_frame_set_xalign () |
float | gtk_aspect_frame_get_xalign () |
void | gtk_aspect_frame_set_yalign () |
float | gtk_aspect_frame_get_yalign () |
void | gtk_aspect_frame_set_ratio () |
float | gtk_aspect_frame_get_ratio () |
void | gtk_aspect_frame_set_obey_child () |
gboolean | gtk_aspect_frame_get_obey_child () |
void | gtk_aspect_frame_set_child () |
GtkWidget * | gtk_aspect_frame_get_child () |
Implemented Interfaces
GtkAspectFrame implements GtkAccessible, GtkBuildable and GtkConstraintTarget.
Description
GtkAspectFrame is useful when you want pack a widget so that it can resize while retaining the same aspect ratio. For instance, one might be drawing a small preview of a larger image.
The frame can respect the aspect ratio of the child widget, or use its own aspect ratio.
Functions
gtk_aspect_frame_new ()
GtkWidget * gtk_aspect_frame_new (float xalign
,float yalign
,float ratio
,gboolean obey_child
);
Create a new GtkAspectFrame.
Parameters
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 (top aligned) to 1.0 (bottom aligned) |
|
ratio |
The desired aspect ratio. |
|
obey_child |
If |
gtk_aspect_frame_set_xalign ()
void gtk_aspect_frame_set_xalign (GtkAspectFrame *self
,float xalign
);
Sets the horizontal alignment of the child within the allocation of the GtkAspectFrame.
gtk_aspect_frame_get_xalign ()
float
gtk_aspect_frame_get_xalign (GtkAspectFrame *self
);
Returns the horizontal alignment of the child within the allocation of the GtkAspectFrame.
gtk_aspect_frame_set_yalign ()
void gtk_aspect_frame_set_yalign (GtkAspectFrame *self
,float yalign
);
Sets the vertical alignment of the child within the allocation of the GtkAspectFrame.
gtk_aspect_frame_get_yalign ()
float
gtk_aspect_frame_get_yalign (GtkAspectFrame *self
);
Returns the vertical alignment of the child within the allocation of the GtkAspectFrame.
gtk_aspect_frame_set_ratio ()
void gtk_aspect_frame_set_ratio (GtkAspectFrame *self
,float ratio
);
Sets the desired aspect ratio of the child.
gtk_aspect_frame_get_ratio ()
float
gtk_aspect_frame_get_ratio (GtkAspectFrame *self
);
Returns the desired aspect ratio of the child set using
gtk_aspect_frame_set_ratio()
.
gtk_aspect_frame_set_obey_child ()
void gtk_aspect_frame_set_obey_child (GtkAspectFrame *self
,gboolean obey_child
);
Sets whether the aspect ratio of the child's size request should override the set aspect ratio of the GtkAspectFrame.
gtk_aspect_frame_get_obey_child ()
gboolean
gtk_aspect_frame_get_obey_child (GtkAspectFrame *self
);
Returns whether the child's size request should override the set aspect ratio of the GtkAspectFrame.
gtk_aspect_frame_set_child ()
void gtk_aspect_frame_set_child (GtkAspectFrame *self
,GtkWidget *child
);
Sets the child widget of self
.
gtk_aspect_frame_get_child ()
GtkWidget *
gtk_aspect_frame_get_child (GtkAspectFrame *self
);
Gets the child widget of self
.
Property Details
The “child”
property
“child” GtkWidget *
The child widget of the GtkAspectFrame.
Owner: GtkAspectFrame
Flags: Read / Write
The “obey-child”
property
“obey-child” gboolean
Whether the GtkAspectFrame should use the aspect ratio of its “child” widget.
Owner: GtkAspectFrame
Flags: Read / Write
Default value: TRUE
The “ratio”
property
“ratio” float
The aspect ratio to be used by the GtkAspectFrame.
This property is only used if “obey-child” is
set to FALSE
.
Owner: GtkAspectFrame
Flags: Read / Write
Allowed values: [0.0001,10000]
Default value: 1
The “xalign”
property
“xalign” float
The horizontal alignment of the “child” widget of the aspect frame.
Owner: GtkAspectFrame
Flags: Read / Write
Allowed values: [0,1]
Default value: 0.5
The “yalign”
property
“yalign” float
The vertical alignment of the “child” widget of the aspect frame.
Owner: GtkAspectFrame
Flags: Read / Write
Allowed values: [0,1]
Default value: 0.5