MWAPI - NEXTG

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

NEXTG indicates the action that occurs if, while this gadget has focus, the user presses the key sequence that requests movement to the next gadget. The key sequence that requests movement to the next gadget is determined by the underlying windowing platform or the MWAPI implementation.

If an application attempts to assign a value to NEXTG which does not identify a gadget that has been defined for the same window, an error condition occurs with $ECODE containing ",M?4," and $EREF containing a value that indicates the ssvn reference for which the error occurred.

If the NEXTG elattribute for gadget G₁ identifies a gadget G that cannot get focus, that gadget’s NEXTG elattribute determines where focus goes. This process is repeated for successive Gs until (a) gadget G’s NEXTG elattribute identifies gadget G₁ or a previous gadget G, or gadget G’s NEXTG elattribute is not specified, in which case focus remains at gadget G₁; or (b) gadget G’s NEXT elattribute identifies a gadget G_n which can get focus is reached, in which case focus goes to gadget G_n.

The effect is not specified if NEXTG identifies a gadget whose ACTIVE or VISIBLE elattribute is FALSE or if NEXTG identifies a gadget that is obscured or if NEXTG identifies a gadget that has been destroyed after the value identifying it was assigned to NEXTG.