delayed

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.

For the split-bar control, the delayed property determines whether side effects occur continuously during a drag, or only once at the end of a drag.

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: when nil, the on-change functions of both the up-down-control and its buddy editable-text widget (if any) will be called each time the value increments as the user holds the mouse button down after clicking on the up-down-control.

  When t: the on-change functions of both the up-down-control and its buddy editable-text widget (if any) will be called a single time when the mouse button is released, though the incrementing values will still be displayed in the buddy widget as the user holds the mouse button 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.
• split-bar
  • value nil: Side effects are performed continously as the user drags the split-bar to a new location. (That is, once each time the system notices that the split-bar has moved by one or more pixels.) Side effects include moving and resizing any widgets in the widgets-to-move and widgets-to-resize properties, as well as calling the split-bar's on-change function if any.
  • value true: Side effects are performed only once at the end of drag.

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.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page has had moderate revisions compared to the 8.1 page.
Created 2016.6.21.