C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
_wgetfocus
 Summary Example                         Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
     The _wgetfocus function determines which of a QuickWin program's
     child (document) windows is active (has the program's "focus").
     The routine returns the file handle of the active child window.
     If the entire application is not active, the routine returns the
     handle of the child window that would be active if the
     application were active.
 
     This routine is used only in QuickWin programs; it is not part of
     the Windows API. For full details about QuickWin, see Chapter 8
     of the Programming Techniques manual.
 
     If the active window is a closed child window kept on the screen
     with the _WINPERSIST flag, _wgetfocus fails.
     See: _wclose
 
     Return Value
 
     If successful, _wgetfocus returns the file handle of the active
     child window. A return value of -1 indicates an error.
                                    -♦-