All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

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.

See also

get-horizontal-scroll-parameters
get-vertical-scroll-parameters
scroll


CAPI User Guide and Reference Manual (Macintosh version) - 01 Dec 2021 19:31:27