get-scroll-position

get-scroll-position Generic Function

Summary

Returns the current scroll position of a pane such as list-panel, display-pane or tree-view.

Package

capi

Signature

get-scroll-position pane dimension => position

Arguments

`pane`⇩	A pane with built-in scrolling.
`dimension`⇩	A keyword, either `:horizontal` or `:vertical`.

Values

position⇩

An integer or nil.

Description

The generic function get-scroll-position returns the scroll position of the pane pane in the given dimension.

pane should be an instance of a pane class that has built-in scrolling. That is, the scrolling is implemented by the underlying widget. Examples include list-panel, display-pane and tree-view.

In general, the units in the returned value position are unspecified, but they can be passed to the generic function scroll with operation :move to restore the position.

For a list-panel, the vertical units are items.

position is nil if pane is not displayed on the screen, for example if get-scroll-position is called after pane is destroyed.