delayed

Generic Function

Package: common-graphics

Arguments: standard-object

Returns the value of the delayed property of standard-object.

For a scroll-type control such as a horizontal-scroll-bar or a trackbar, the delayed property determines whether on-change is called to update the control's value continuously as the user drags the scroll-box or pointer along the slider, or whether it is called only once at the end of the scroll gesture.

For text controls such as an editable-text or combo-box, the delayed property determines whether on-change is called to update the control's value as each character is typed, or whether it is called only once after the user has finished typing and moves the keyboard focus from the control. If you use the the delayed property on one of those controls but you need the latest value of the control, you may have to use fetch-control-value rather than value. Examples are given in the description of fetch-control-value.

Here are the widgets, along with the values and the associated behaviors.

• editable-text
  • value nil: Editable text is updated immediately after each keystroke.
  • value t: Editable text is updated when the keyboard focus moves from the control.
• multi-line-editable-text
  • value nil: Editable text is updated immediately after each keystroke.
  • value t: Editable text is updated when the keyboard focus moves from the control.
• up-down-control
  • value nil: the value of the spin box is incremented as long as the mouse button is held down after clicking on it.
  • value t: the value of the spin box is incremented only one time for the mouse click, no matter how long the mouse button is held down.
• horizontal-scroll-bar and vertical-scroll-bar
  • value nil: on-change is invoked each time the mouse is moved a bit as the user drags the slider.
  • value t: on-change is invoked only at the completion of the slider drag.
• trackbar
  • value nil: on-change is invoked each time the mouse is moved a bit as the user drags the slider.
  • value t: on-change is invoked only at the completion of the slider drag on the trackbar.

delayed is a property of the following classes:

combo-box, editable-text, horizontal-scroll-bar, multi-line-editable-text, trackbar, up-down-control, vertical-scroll-bar.

Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.

The documentation is described in introduction.htm and the index is in index.htm.

Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.

Created 2000.10.5.