Top |
GObject ╰── GInitiallyUnowned ╰── GtkWidget ╰── GtkContainer ╰── GtkBin ╰── GtkViewport
The GtkViewport widget acts as an adaptor class, implementing scrollability for child widgets that lack their own scrolling capabilities. Use GtkViewport to scroll child widgets such as GtkGrid, GtkBox, and so on.
If a widget has native scrolling abilities, such as GtkTextView,
GtkTreeView or GtkIconView, it can be added to a GtkScrolledWindow
with gtk_container_add()
. If a widget does not, you must first add the
widget to a GtkViewport, then add the viewport to the scrolled window.
gtk_container_add()
does this automatically if a child that does not
implement GtkScrollable is added to a GtkScrolledWindow, so you can
ignore the presence of the viewport.
The GtkViewport will start scrolling content only if allocated less than the child widget’s minimum size in a given orientation.
GtkWidget * gtk_viewport_new (GtkAdjustment *hadjustment
,GtkAdjustment *vadjustment
);
Creates a new GtkViewport with the given adjustments, or with default adjustments if none are given.
GtkAdjustment *
gtk_viewport_get_hadjustment (GtkViewport *viewport
);
gtk_viewport_get_hadjustment
has been deprecated since version 3.0 and should not be used in newly-written code.
Returns the horizontal adjustment of the viewport.
GtkAdjustment *
gtk_viewport_get_vadjustment (GtkViewport *viewport
);
gtk_viewport_get_vadjustment
has been deprecated since version 3.0 and should not be used in newly-written code.
Returns the vertical adjustment of the viewport.
void gtk_viewport_set_hadjustment (GtkViewport *viewport
,GtkAdjustment *adjustment
);
gtk_viewport_set_hadjustment
has been deprecated since version 3.0 and should not be used in newly-written code.
Sets the horizontal adjustment of the viewport.
void gtk_viewport_set_vadjustment (GtkViewport *viewport
,GtkAdjustment *adjustment
);
gtk_viewport_set_vadjustment
has been deprecated since version 3.0 and should not be used in newly-written code.
Sets the vertical adjustment of the viewport.
void gtk_viewport_set_shadow_type (GtkViewport *viewport
,GtkShadowType type
);
Sets the shadow type of the viewport.
GtkShadowType
gtk_viewport_get_shadow_type (GtkViewport *viewport
);
Gets the shadow type of the GtkViewport. See
gtk_viewport_set_shadow_type()
.
GdkWindow *
gtk_viewport_get_bin_window (GtkViewport *viewport
);
Gets the bin window of the GtkViewport.
Since: 2.20
GdkWindow *
gtk_viewport_get_view_window (GtkViewport *viewport
);
Gets the view window of the GtkViewport.
Since: 2.22
“shadow-type”
property“shadow-type” GtkShadowType
Determines how the shadowed box around the viewport is drawn.
Owner: GtkViewport
Flags: Read / Write
Default value: GTK_SHADOW_IN