MacroPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.2
Unrevised from 8.1 to 8.2.
8.1 version

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.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.2
Unrevised from 8.1 to 8.2.
8.1 version