MWAPI - NEXTG

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

NEXTG indicates the action that occurs if this window receives focus but no gadget within the window receives focus.

If an application attempts to assign a value to NEXTG that does not identify a gadget that has been defined for the 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 wattribute for window W 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 a previously identified gadget G or gadget G’s NEXTG elattribute is not specified, in which case focus remains at window W; 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 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.