MWAPI - FOCUS

1995 Version of ANSI (Equivalent to Current ISO Version) of 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 no window created by the application has focus, or 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 but a focus event does not occur.

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 cannot get focus in the underlying windowing platform, an error condition occurs with $ECODE containing ",M?4," and $EREF containing a value that indicates the ssvn reference for which the error occurred.