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

NextPrevUpTopContentsIndex

scroll-if-not-visible-p

Generic Function
Summary

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

Signature

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

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

Values

value

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

Description

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:

t

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.

nil

Never scroll the parent to make a pane visible.

:non-mouse

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

simple-pane
Programming with CAPI Windows


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

NextPrevUpTopContentsIndex