MWAPI - FOCUS

Draft MDC Standard

FOCUS identifies the window and gadget, if any, which has focus; that is, to which keyboard and pointer input associated with this display are sent. If the window or gadget which has focus is destroyed, the value is platform dependent.

If an application assigns a value to FOCUS which identifies a window or gadget defined in ^$WINDOW, that window or gadget receives focus.

If an application sets focus to a window that is iconified, the window is restored.

If an application attempts to set focus to a window or gadget that is not currently visible and active, or to set focus to a gadget that is incapable of getting focus in the underlying windowing platform, or to set focus to a window that is disabled because of the value of the MODAL wattribute of another window, or to set focus to a window with a DISPLAY wattribute value that identifies a different display, an error condition occurs with an ecode = "M49" and $EREF containing a value that indicates the ssvn reference for which the error occurred.