Gtk.Scrollable – gtk+-3.0 – Vala Binding Reference

Description:

[ CCode ( type_cname = "GtkScrollableInterface" , type_id = "gtk_scrollable_get_type ()" ) ]
public interface Scrollable : Object

Scrollable is an interface that is implemented by widgets with native scrolling ability.

To implement this interface you should override the hadjustment and vadjustment properties.

Creating a scrollable widget

All scrollable widgets should do the following.

When a parent widget sets the scrollable child widget’s adjustments, the widget should populate the adjustments’ lower, upper, step_increment, page_increment and page_size properties and connect to the value_changed signal.
Because its preferred size is the size for a fully expanded widget, the scrollable widget must be able to cope with underallocations. This means that it must accept any value passed to its size_allocate function.
When the parent allocates space to the scrollable child widget, the widget should update the adjustments’ properties with new values.
When any of the adjustments emits the value_changed signal, the scrollable widget should scroll its contents.

Namespace: Gtk

Package: gtk+-3.0

Content:

Properties:

public Adjustment hadjustment { get; set construct; }

Horizontal Adjustment of the scrollable widget.

public ScrollablePolicy hscroll_policy { get; set; }

Determines whether horizontal scrolling should start once the scrollable widget is allocated less than its minimum width or less than its natural width.

public Adjustment vadjustment { get; set construct; }

Verical Adjustment of the scrollable widget.

public ScrollablePolicy vscroll_policy { get; set; }

Determines whether vertical scrolling should start once the scrollable widget is allocated less than its minimum height or less than its natural height.

Methods:

public abstract bool get_border (out Border border)

Returns the size of a non-scrolling border around the outside of the scrollable.

public unowned Adjustment get_hadjustment ()

Retrieves the Adjustment used for horizontal scrolling.

public ScrollablePolicy get_hscroll_policy ()

Gets the horizontal ScrollablePolicy.

public unowned Adjustment get_vadjustment ()

Retrieves the Adjustment used for vertical scrolling.

public ScrollablePolicy get_vscroll_policy ()

Gets the vertical ScrollablePolicy.

public void set_hadjustment (Adjustment? hadjustment)

Sets the horizontal adjustment of the Scrollable.

public void set_hscroll_policy (ScrollablePolicy policy)

Sets the ScrollablePolicy to determine whether horizontal scrolling should start below the minimum width or below the natural width.

public void set_vadjustment (Adjustment? vadjustment)

Sets the vertical adjustment of the Scrollable .

public void set_vscroll_policy (ScrollablePolicy policy)

Sets the ScrollablePolicy to determine whether vertical scrolling should start below the minimum height or below the natural height.

Inherited Members:

All known members inherited from class GLib.Object

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref