MWAPI - DEFBUTTON

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

DEFBUTTON specifies the default push button for the window. If the value of DEFBUTTON specifies a gadget which is a child of the window and which has a TYPE attribute value of "BUTTON", the user can "push" the specified button, that is cause it to generate a SELECT event, by pressing a key on the keyboard. The specific key to be pressed is defined by the underlying windowing platform.

If an application attempts to assign a value to DEFBUTTON which (a) does not specify a gadget which is a child of the window or (b) does not identify a gadget with a TYPE elattribute value equal to "BUTTON", an error condition occurs with $ECODE containing ",M?7," and $EREF containing a value that indicates the ssvn reference for which the invalid DEFBUTTON value was assigned.

The effect is not specified if DEFBUTTON identifies a gadget that has been destroyed after the value identifying it was assigned to DEFBUTTON.