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



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



One of t, nil or :non-mouse.

Method Signature

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

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


The generic function scroll-if-not-visible-p accesses the scroll-if-not-visible-p attribute of a pane.

The value of this attribute has these meanings:


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

Programming with CAPI Windows

CAPI User Guide and Reference Manual (Macintosh version) - 3 Aug 2017