Top |
Functions
GtkWidget * | gtk_layout_new () |
void | gtk_layout_put () |
void | gtk_layout_move () |
void | gtk_layout_set_size () |
void | gtk_layout_get_size () |
void | gtk_layout_freeze () |
void | gtk_layout_thaw () |
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 () |
Properties
GtkAdjustment * | hadjustment | Read / Write |
guint | height | Read / Write |
GtkAdjustment * | vadjustment | Read / Write |
guint | width | Read / Write |
Object Hierarchy
GObject ╰── GInitiallyUnowned ╰── GtkObject ╰── GtkWidget ╰── GtkContainer ╰── GtkLayout
Description
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.
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_freeze ()
void
gtk_layout_freeze (GtkLayout *layout
);
gtk_layout_freeze
is deprecated and should not be used in newly-written code.
This is a deprecated function, it doesn't do anything useful.
gtk_layout_thaw ()
void
gtk_layout_thaw (GtkLayout *layout
);
gtk_layout_thaw
is deprecated and should not be used in newly-written code.
This is a deprecated function, it doesn't do anything useful.
gtk_layout_get_hadjustment ()
GtkAdjustment *
gtk_layout_get_hadjustment (GtkLayout *layout
);
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
);
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
);
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
);
Sets the vertical scroll adjustment for the layout.
See GtkScrolledWindow, GtkScrollbar, GtkAdjustment for details.
Property Details
The “hadjustment”
property
“hadjustment” GtkAdjustment *
The GtkAdjustment for the horizontal position.
Flags: Read / Write
The “height”
property
“height” guint
The height of the layout.
Flags: Read / Write
Allowed values: <= G_MAXINT
Default value: 100
The “vadjustment”
property
“vadjustment” GtkAdjustment *
The GtkAdjustment for the vertical position.
Flags: Read / Write
The “width”
property
“width” guint
The width of the layout.
Flags: Read / Write
Allowed values: <= G_MAXINT
Default value: 100
Signal Details
The “set-scroll-adjustments”
signal
void user_function (GtkLayout *horizontal, GtkAdjustment *vertical, GtkAdjustment *arg2, gpointer user_data)
Set the scroll adjustments for the layout. Usually scrolled containers like GtkScrolledWindow will emit this signal to connect two instances of GtkScrollbar to the scroll directions of the GtkLayout.
Parameters
horizontal |
the horizontal GtkAdjustment |
|
vertical |
the vertical GtkAdjustment |
|
user_data |
user data set when the signal handler was connected. |
Flags: Action