Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄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.
                                    -♦-