StScrollView: Cinnamon St Reference Manual

## StScrollView StScrollView — a container for scrollable children |

## Functions

StWidget * | st_scroll_view_new ()
ClutterActor * | st_scroll_view_get_hscroll_bar ()
ClutterActor * | st_scroll_view_get_vscroll_bar ()
gfloat | st_scroll_view_get_column_size ()
void | st_scroll_view_set_column_size ()
gfloat | st_scroll_view_get_row_size ()
void | st_scroll_view_set_row_size ()
void | st_scroll_view_set_mouse_scrolling ()
gboolean | st_scroll_view_get_mouse_scrolling ()
void | st_scroll_view_set_auto_scrolling ()
gboolean | st_scroll_view_get_auto_scrolling ()
void | st_scroll_view_set_policy ()

## Properties

gboolean | enable-auto-scrolling | Read / Write
gboolean | enable-mouse-scrolling | Read / Write
StScrollBar * | hscroll | Read
GtkPolicyType | hscrollbar-policy | Read / Write
gboolean | hscrollbar-visible | Read
StScrollBar * | vscroll | Read
GtkPolicyType | vscrollbar-policy | Read / Write
gboolean | vscrollbar-visible | Read

## Types and Values

struct | StScrollView

## Object Hierarchy

        GObject
        ╰── GInitiallyUnowned
            ╰── ClutterActor
                ╰── StWidget
                    ╰── StBin
                        ╰── StScrollView

## Implemented Interfaces

StScrollView implements ClutterContainer, ClutterScriptable, ClutterAnimatable and AtkImplementorIface.

## Description

StScrollView is a single child container for actors that implement StScrollable. It provides scrollbars around the edge of the child to allow the user to move around the scrollable area.

## Functions

### st_scroll_view_new ()

    StWidget *
    st_scroll_view_new (void);

### st_scroll_view_get_hscroll_bar ()

    ClutterActor *
    st_scroll_view_get_hscroll_bar (StScrollView *scroll);

Gets the horizontal scrollbar of the scrollbiew

#### Parameters

scroll | a StScrollView |

#### Returns

the horizontal StScrollbar.

[transfer none]

### st_scroll_view_get_vscroll_bar ()

    ClutterActor *
    st_scroll_view_get_vscroll_bar (StScrollView *scroll);

Gets the vertical scrollbar of the scrollbiew

#### Parameters

scroll | a StScrollView |

#### Returns

the vertical StScrollbar.

[transfer none]

### st_scroll_view_get_column_size ()

    gfloat
    st_scroll_view_get_column_size (StScrollView *scroll);

### st_scroll_view_set_column_size ()

    void
    st_scroll_view_set_column_size (StScrollView *scroll,
                                    gfloat column_size);

### st_scroll_view_get_row_size ()

    gfloat
    st_scroll_view_get_row_size (StScrollView *scroll);

### st_scroll_view_set_row_size ()

    void
    st_scroll_view_set_row_size (StScrollView *scroll,
                                 gfloat row_size);

### st_scroll_view_set_mouse_scrolling ()

    void
    st_scroll_view_set_mouse_scrolling (StScrollView *scroll,
                                        gboolean enabled);

### st_scroll_view_get_mouse_scrolling ()

    gboolean
    st_scroll_view_get_mouse_scrolling (StScrollView *scroll);

### st_scroll_view_set_auto_scrolling ()

    void
    st_scroll_view_set_auto_scrolling (StScrollView *scroll,
                                       gboolean enabled);

### st_scroll_view_get_auto_scrolling ()

    gboolean
    st_scroll_view_get_auto_scrolling (StScrollView *scroll);

### st_scroll_view_set_policy ()

    void
    st_scroll_view_set_policy (StScrollView *scroll,
                               GtkPolicyType hscroll,
                               GtkPolicyType vscroll);

Set the scroll policy.

#### Parameters

scroll | A StScrollView |
hscroll | Whether to enable horizontal scrolling |
vscroll | Whether to enable vertical scrolling |

## Types and Values

### struct StScrollView

    struct StScrollView;

The contents of this structure are private and should only be accessed through the public API.

## Property Details

### The `“enable-auto-scrolling”` property

      “enable-auto-scrolling”    gboolean

Enable automatic scrolling.

Flags: Read / Write

Default value: FALSE

### The `“enable-mouse-scrolling”` property

      “enable-mouse-scrolling”   gboolean

Enable automatic mouse wheel scrolling.

Flags: Read / Write

Default value: TRUE

### The `“hscroll”` property

      “hscroll”                  StScrollBar *

Horizontal scroll indicator.

Flags: Read

### The `“hscrollbar-policy”` property

      “hscrollbar-policy”        GtkPolicyType

When the horizontal scrollbar is displayed.

Flags: Read / Write

Default value: GTK_POLICY_AUTOMATIC

### The `“hscrollbar-visible”` property

      “hscrollbar-visible”       gboolean

Whether the horizontal scrollbar is visible.

Flags: Read

Default value: TRUE

### The `“vscroll”` property

      “vscroll”                  StScrollBar *

Vertical scroll indicator.

Flags: Read

### The `“vscrollbar-policy”` property

      “vscrollbar-policy”        GtkPolicyType

When the vertical scrollbar is displayed.

Flags: Read / Write

Default value: GTK_POLICY_AUTOMATIC

### The `“vscrollbar-visible”` property

      “vscrollbar-visible”       gboolean

Whether the vertical scrollbar is visible.

Flags: Read

Default value: TRUE