MWAPI - NEXTG

Draft MDC 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.

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 an ecode = "M49" 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 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.