_WINDOWHASFOCUS - QB64 Wiki

_WINDOWHASFOCUS

From QB64 Wiki

Revision as of 14:54, 30 December 2017 by SMcNeill (Talk | contribs)
(diff) ← Older revision | Current revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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


Contents

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).
  • Not available in MacOS (but is available in Linux, see availability below).
  • A window is normally defocused by clicking on another window, but Linux environments can be configured to only require the mouse be moved over another window. This should not affect your use of _WINDOWHASFOCUS.


Availability

  • Build 20170924/68 (Windows)
  • Build 20171230/83 (Linux)


Examples

Example: Detecting if the current program has focus.

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



Navigation:
Go to Keyword Reference - Alphabetical
Go to Keyword Reference - By usage
Go to Main WIKI Page
Personal tools