Button for 1977 Button for 1984 Button for 1990 Button for 1995 Button for MDC Button for notes Button for examples
Left Hand Pointer

MWAPI - VALUE

1995 Version of ANSI (Equivalent to Current ISO Version) of Standard

Right Hand Pointer

6.4.41 VALUE elattribute

Definition

VALUE specifies the data associated with or represented by the gadget.

For a check box gadget, if the user selects the gadget, VALUE is set to 1 (one). If the user deselects the gadget, VALUE is set to 0 (zero). If a value that is assigned by the application evaluates to TRUE, the gadget is selected. If a value that is assigned by the application evaluates to FALSE, the gadget is deselected.

For a document, list entry box or text gadget, VALUE specifies the text value. Within a document text value, each linend indicates that, when the text value is displayed, the character following the linend should begin a new line. Otherwise, the formatting mechanisms used for displaying a document text value are determined by the underlying windowing platform, if there is one, and by the MWAPI otherwise.

For a list box or long list box gadget, VALUE specifies the number of choices selected. The choices selected are indicated by descendant nodes, of the form

^$W[INDOW] ( wname , gkeyword , gname , vkeyword , item )

where

    vkeyword::= expr V VALUE

and item identifies a selected choice. The value of these nodes is the emptystring. If an application attempts to create a descendant node of VALUE which has an item that does not identify a defined choice for the gadget, an error condition occurs with $ECODE containing ",M?3," and $EREF containing a value that indicates the ssvn reference for which the error occurred.

For a list box or long list box gadget, an application can assign values to descendant nodes of VALUE, but it cannot assign a value to the VALUE node itself. However, an application can use an M[UMPS] KILL command of the form

^$W[INDOW] ( wname , gkeyword , gname , vkeyword )

to deselect all current selections in a list box or long list box.

For a radio button set or list button gadget, VALUE specifies the item value of the selected choice. If an application attempts to assign to VALUE an item that does not identify a defined choice for the gadget, an error condition occurs with $ECODE containing ",M?3," and $EREF containing a value that indicates the ssvn reference for which the error occurred. If no choice is selected, the value of VALUE is an emptystring.

For a scroll gadget, VALUE specifies the value represented by the value indicator.

Domain For a check box gadget, truefalse.
For a document gadget, longchars.
For a list entry box or text gadget, chars.
For a list box or long list box gadget, VALUE has a domain of intexpr and descendant nodes have a domain of emptystring.
For a radio button set or list button gadget, item or emptystring.
For a scroll gadget, numexpr.
Access Create, Modify, Reference
Default For a check box gadget, 0 (zero).
For a document, list button, list entry box, radio button set, or text gadget, emptystring.
For a list box or long list box gadget, 0 (zero) with no descendant nodes.
For a scroll gadget, the value of the scrollmin component of the SCROLLRANGE elattribute.
Button for 1977 Button for 1984 Button for 1990 Button for 1995 Button for MDC Button for notes Button for examples

Copyright © Standard Documents; 1977-2018 MUMPS Development Committee;
Copyright © Examples: 1995-2018 Ed de Moel;
Copyright © Annotations: 2003-2008 Jacquard Systems Research
Copyright © Annotations: 2008-2018 Ed de Moel.

This page most recently updated on 29-Nov-2011, 20:03:11 .

For comments, contact Ed de Moel (demoel@jacquardsystems.com)