_WINDOWHASFOCUS

The _WINDOWHASFOCUS function returns true (-1) if the current program's window has focus. Not supported for macOS.

Syntax

hasFocus%% = _WINDOWHASFOCUS

Description

• The function returns true (-1) if the current program is the topmost window on the user's desktop and has focus. If the current program is running behind another window, the function returns false (0).
• Keyword not supported in macOS versions

Availability

• 

  v1.2

• 

  all

• 
• 

  yes

• 

  yes

• 

  no

Examples

Example: Detecting if the current program has focus. Windows and Linux-only.

DO IF _WINDOWHASFOCUS THEN COLOR 15, 6 CLS PRINT "*** Hi there! ***" ELSE COLOR 0, 7 CLS PRINT "(ain't nobody looking...)" END IF _DISPLAY _LIMIT 30 LOOP

Explanation: The program will display "*** Hi There! ***" while the window is the topmost and is being manipulated by the user. If another window, the taskbar or the desktop are clicked, the program window loses focus and the message "(ain't nobody looking...)" is displayed.

See also

• _WINDOWHANDLE
• _SCREENEXISTS

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage