without-on-change

Arguments: ( &rest widgets) &body body

This macro is useful for suppressing the usual running of the on-change code of one or more widgets while a body of application code is executed.

Evaluates body while the value of the on-change event handler property for each dialog-item in widgets is temporarily set to nil. Returns whatever the last form in body returns.

The original value of each on-change event handler is restored when body completes. An unwind-protect ensures this restoration in case of a break or a throw in body.

Each value in the widgets list should be an expression that evaluates to either a dialog-item instance or to nil. When nil, nothing is done for that member of the list.

Examples of the calling format

(without-on-change (widget1)
  (do-something)
  (do-something-else))

(without-on-change ((find-component :widget1 my-dialog))
  (do-something))

(without-on-change (widget1 widget2
                    (find-component :widget3 my-dialog)
                    (find-component :widget4 my-dialog))
  (do-something))

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.