MWAPI - NEXTG

Draft MDC Standard

NEXTG indicates the action that occurs if this window receives focus but no gadget within the window receives focus. NEXTG only has effect the first time a window receives focus after it is created or the first time a window receives focus after its VISIBLE wattribute value changes from FALSE to TRUE.

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 an ecode = "M49" 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 NEXTG 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 that has been destroyed after the value identifying it was assigned to NEXTG.

If the window is in build mode the wattribute may be set and referenced but is ignored.