| Top |  |
 |
 |
 |
Functions
| GtkWidget * | gtk_layout_new () |
| void | gtk_layout_put () |
| void | gtk_layout_move () |
| void | gtk_layout_set_size () |
| void | gtk_layout_get_size () |
| GtkAdjustment * | gtk_layout_get_hadjustment () |
| GtkAdjustment * | gtk_layout_get_vadjustment () |
| void | gtk_layout_set_hadjustment () |
| void | gtk_layout_set_vadjustment () |
| GdkWindow * | gtk_layout_get_bin_window () |
Description
GtkLayout is similar to GtkDrawingArea in that it’s a “blank slate” and doesn’t do anything except paint a blank background by default. It’s different in that it supports scrolling natively due to implementing GtkScrollable, and can contain child widgets since it’s a GtkContainer.
If you just want to draw, a GtkDrawingArea is a better choice since it has lower overhead. If you just need to position child widgets at specific points, then GtkFixed provides that functionality on its own.
When handling expose events on a GtkLayout, you must draw to the GdkWindow
returned by gtk_layout_get_bin_window(), rather than to the one returned by
gtk_widget_get_window() as you would for a GtkDrawingArea.
Functions
gtk_layout_new ()
GtkWidget * gtk_layout_new (GtkAdjustment *hadjustment,GtkAdjustment *vadjustment);
Creates a new GtkLayout. Unless you have a specific adjustment
you’d like the layout to use for scrolling, pass NULL for
hadjustment
and vadjustment
.
gtk_layout_put ()
void gtk_layout_put (GtkLayout *layout,GtkWidget *child_widget,gint x,gint y);
Adds child_widget
to layout
, at position (x
,y
).
layout
becomes the new parent container of child_widget
.
gtk_layout_move ()
void gtk_layout_move (GtkLayout *layout,GtkWidget *child_widget,gint x,gint y);
Moves a current child of layout
to a new position.
gtk_layout_set_size ()
void gtk_layout_set_size (GtkLayout *layout,guint width,guint height);
Sets the size of the scrollable area of the layout.
gtk_layout_get_size ()
void gtk_layout_get_size (GtkLayout *layout,guint *width,guint *height);
Gets the size that has been set on the layout, and that determines
the total extents of the layout’s scrollbar area. See
gtk_layout_set_size().
gtk_layout_get_hadjustment ()
GtkAdjustment *
gtk_layout_get_hadjustment (GtkLayout *layout);
gtk_layout_get_hadjustment has been deprecated since version 3.0 and should not be used in newly-written code.
This function should only be called after the layout has been
placed in a GtkScrolledWindow or otherwise configured for
scrolling. It returns the GtkAdjustment used for communication
between the horizontal scrollbar and layout
.
See GtkScrolledWindow, GtkScrollbar, GtkAdjustment for details.
gtk_layout_get_vadjustment ()
GtkAdjustment *
gtk_layout_get_vadjustment (GtkLayout *layout);
gtk_layout_get_vadjustment has been deprecated since version 3.0 and should not be used in newly-written code.
This function should only be called after the layout has been
placed in a GtkScrolledWindow or otherwise configured for
scrolling. It returns the GtkAdjustment used for communication
between the vertical scrollbar and layout
.
See GtkScrolledWindow, GtkScrollbar, GtkAdjustment for details.
gtk_layout_set_hadjustment ()
void gtk_layout_set_hadjustment (GtkLayout *layout,GtkAdjustment *adjustment);
gtk_layout_set_hadjustment has been deprecated since version 3.0 and should not be used in newly-written code.
Sets the horizontal scroll adjustment for the layout.
See GtkScrolledWindow, GtkScrollbar, GtkAdjustment for details.
gtk_layout_set_vadjustment ()
void gtk_layout_set_vadjustment (GtkLayout *layout,GtkAdjustment *adjustment);
gtk_layout_set_vadjustment has been deprecated since version 3.0 and should not be used in newly-written code.
Sets the vertical scroll adjustment for the layout.
See GtkScrolledWindow, GtkScrollbar, GtkAdjustment for details.
Property Details
The “height” property
“height” guint
The height of the layout.
Owner: GtkLayout
Flags: Read / Write
Allowed values: <= G_MAXINT
Default value: 100