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

scroll-if-not-visible-p Accessor Generic Function


Accesses the scroll-if-not-visible-p attribute of a pane.




scroll-if-not-visible-p pane => value

(setf scroll-if-not-visible-p) value pane => value

Method signatures

scroll-if-not-visible-p (pane simple-pane)

(setf scroll-if-not-visible-p) value (pane simple-pane)

A pane.
One of t, nil or :non-mouse.
One of t, nil or :non-mouse.

The accessor generic function scroll-if-not-visible-p gets and sets the scroll-if-not-visible-p attribute of pane.

value can be one of the following:

When pane is given the input focus, and it is not fully visible, and its parent can be scrolled to make the pane visible, then the parent is scrolled automatically. This is the default value.
Never scroll the parent to make a pane visible.
Like t, except that it does not scroll when the focus is given as a result of a mouse click in pane.

scroll-if-not-visible-p is called by CAPI each time it may need to scroll the parent. The method on simple-pane returns a value that is kept internally, and can be set by the default setf method.

You can specialize scroll-if-not-visible-p on your classes, but note that it is called often when the user clicks on any pane, so it must be reasonably fast.

The setter sets the scroll-if-not-visible-p attribute. It is called when the initarg :scroll-if-not-visible-p is used in making a simple-pane (or a subclass) instance, and can be called by your program. value must be t, nil or :non-mouse.

The method on simple-pane sets the internal value that is used by scroll-if-not-visible-p on simple-pane.

See also

7 Programming with CAPI Windows

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