| GTK+ Reference Manual | |||
|---|---|---|---|
| <<< Prev | Home | Up | Next >>> |
GtkAspectFrame — A frame that constrains its child to a particular aspect ratio.
#include <gtk/gtk.h> struct GtkAspectFrame; GtkWidget* gtk_aspect_frame_new (const gchar *label, gfloat xalign, gfloat yalign, gfloat ratio, gboolean obey_child); void gtk_aspect_frame_set (GtkAspectFrame *aspect_frame, gfloat xalign, gfloat yalign, gfloat ratio, gboolean obey_child);
GObject +----GtkObject +----GtkWidget +----GtkContainer +----GtkBin +----GtkFrame +----GtkAspectFrame
"xalign" gfloat : Read / Write "yalign" gfloat : Read / Write "ratio" gfloat : Read / Write "obey-child" gboolean : Read / Write
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 TRUE, ratio is ignored, and the aspect ratio is taken from the requistion of the child. |
| Returns : | the new GtkAspectFrame. |
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 TRUE, ratio is ignored, and the aspect ratio is taken from the requistion of the child. |
| <<< Prev | Home | Up | Next >>> |
| GtkAlignment | GtkHBox | ||