st-scroll-view: St Reference Manual

## st-scroll-view st-scroll-view — 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_overlay_scrollbars ()
gboolean | st_scroll_view_get_overlay_scrollbars ()
void | st_scroll_view_set_policy ()
void | st_scroll_view_update_fade_effect ()

## Types and Values

#define | ST_TYPE_SCROLL_VIEW
enum | StPolicyType
struct | StScrollView
| StScrollViewPrivate

## 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_overlay_scrollbars ()

    void
    st_scroll_view_set_overlay_scrollbars (StScrollView *scroll,
                                           gboolean enabled);

Sets whether scrollbars are painted on top of the content.

#### Parameters

scroll | A StScrollView |
enabled | Whether to enable overlay scrollbars |

### st_scroll_view_get_overlay_scrollbars ()

    gboolean
    st_scroll_view_get_overlay_scrollbars (StScrollView *scroll);

Gets the value set by `st_scroll_view_set_overlay_scrollbars()`.

#### Parameters

scroll | A StScrollView |

### st_scroll_view_set_policy ()

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

Set the scroll policy.

#### Parameters

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

### st_scroll_view_update_fade_effect ()

    void
    st_scroll_view_update_fade_effect (StScrollView *scroll,
                                       float vfade_offset,
                                       float hfade_offset);

Sets the height of the fade area area in pixels. A value of 0 disables the effect.

#### Parameters

scroll | a StScrollView |
vfade_offset | The length of the veritcal fade effect, in pixels. |
hfade_offset | The length of the horizontal fade effect, in pixels. |

## Types and Values

### ST_TYPE_SCROLL_VIEW

    #define ST_TYPE_SCROLL_VIEW            (st_scroll_view_get_type())

### enum StPolicyType

#### Members

ST_POLICY_ALWAYS |  |
ST_POLICY_AUTOMATIC |  |
ST_POLICY_NEVER |  |
ST_POLICY_EXTERNAL |  |

### struct StScrollView

    struct StScrollView {
    };

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

### StScrollViewPrivate

    typedef struct _StScrollViewPrivate StScrollViewPrivate;