value

Generic Function

Package: common-graphics

Arguments: standard-object

Returns the value of the value property of the argument. The value property holds the value of a control or component. The format of the value depends on the type of component (it might be a number, a string, a boolean (t or nil), etc.) Often the value is changed by user action, usually in a dialog displayed precisely to get user input.

See fetch-control-value, which forces the operating system to update the value of a control. There are cases (discussed in the description of the generic function) where the value returned by value might be out of date.

When setf'ing the value of a component which has an on-change event handler, the on-change function must return true or the value change will not happen. This is true whether the change is attempted by user action (mouse action on a control, e.g.) or by a call to (setf value).

For controls with a range (such as a trackbar or a combo-box), it is an error to specify a value, either initially with the :value init argument or with setf of value, outside the range.

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.