| GTK+ Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Child Properties | ||||
#include <gtk/gtk.h>
GtkLayout;
GtkWidget* gtk_layout_new (GtkAdjustment *hadjustment,
GtkAdjustment *vadjustment);
void gtk_layout_put (GtkLayout *layout,
GtkWidget *child_widget,
gint x,
gint y);
void gtk_layout_move (GtkLayout *layout,
GtkWidget *child_widget,
gint x,
gint y);
void gtk_layout_set_size (GtkLayout *layout,
guint width,
guint height);
void gtk_layout_get_size (GtkLayout *layout,
guint *width,
guint *height);
GtkAdjustment* gtk_layout_get_hadjustment (GtkLayout *layout);
GtkAdjustment* gtk_layout_get_vadjustment (GtkLayout *layout);
void gtk_layout_set_hadjustment (GtkLayout *layout,
GtkAdjustment *adjustment);
void gtk_layout_set_vadjustment (GtkLayout *layout,
GtkAdjustment *adjustment);
GdkWindow* gtk_layout_get_bin_window (GtkLayout *layout);
GtkLayout is similar to GtkDrawingArea in that it's a "blank slate" and doesn't do anything but paint a blank background by default. It's different in that it supports scrolling natively (you can add it to a GtkScrolledWindow), and it can contain child widgets, since it's a GtkContainer. However if you're just going to draw, a GtkDrawingArea is a better choice since it has lower overhead.
When handling expose events on a GtkLayout, you must draw to GTK_LAYOUT (layout)->bin_window, rather than to GTK_WIDGET (layout)->window, as you would for a drawing area.
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.
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.
|
a GtkLayout |
|
child widget |
|
X position of child widget |
|
Y position of child widget |
void gtk_layout_move (GtkLayout *layout,GtkWidget *child_widget,gint x,gint y);
Moves a current child of layout to a new position.
|
a GtkLayout |
|
a current child of layout
|
|
X position to move to |
|
Y position to move to |
void gtk_layout_set_size (GtkLayout *layout,guint width,guint height);
Sets the size of the scrollable area of the layout.
|
a GtkLayout |
|
width of entire scrollable area |
|
height of entire scrollable area |
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().
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. Use gtk_scrollable_get_hadjustment()
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.
|
a GtkLayout |
Returns : |
horizontal scroll adjustment. [transfer none] |
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. Use gtk_scrollable_get_vadjustment()
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.
|
a GtkLayout |
Returns : |
vertical scroll adjustment. [transfer none] |
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. Use gtk_scrollable_set_hadjustment()
Sets the horizontal scroll adjustment for the layout.
See GtkScrolledWindow, GtkScrollbar, GtkAdjustment for details.
|
a GtkLayout |
|
new scroll adjustment. [allow-none] |
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. Use gtk_scrollable_set_vadjustment()
Sets the vertical scroll adjustment for the layout.
See GtkScrolledWindow, GtkScrollbar, GtkAdjustment for details.
|
a GtkLayout |
|
new scroll adjustment. [allow-none] |
"height" property"height" guint : Read / Write
The height of the layout.
Allowed values: <= G_MAXINT
Default value: 100
"width" property"width" guint : Read / Write
The width of the layout.
Allowed values: <= G_MAXINT
Default value: 100