with-atomic-redisplay Macro

Summary

Delays the updating of specified panes until all state changes have been performed.

Package

capi

Signature

with-atomic-redisplay (&rest panes) &body body => result*

Arguments

panes⇩	Panes.
body⇩	Lisp forms.

Values

result*

Multiple values.

Description

The macro with-atomic-redisplay delays the updating of panes and their descendants until the exit from the with-atomic-redisplay macro.

The forms in body are evaluated as in implicit progn and the value of the last form is returned.

Most CAPI pane slot writers update the visual appearance of the pane at the point that their state changes, but it is sometimes necessary to cause all updates to the pane to be left until after they are all completed. The macro with-atomic-redisplay defers all visible changes to the state of each pane in panes until the end of the scope of the macro.

Notes

1. with-atomic-redisplay does not cause Graphics Ports drawing operations on panes to be deferred.
2. with-atomic-redisplay can be used recursively. The actual display happens when exiting the outermost invocation.

See also

display
simple-pane