WINDOWHASFOCUS: Difference between revisions

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 13: Line 13:


{{PageAvailability}}
{{PageAvailability}}
<!-- QB64 = a version or none, QBPE = a version or all, Platforms = yes or no -->
<gallery widths="48px" heights="48px" mode="nolines">
<gallery widths="48px" heights="48px" mode="nolines">
File:Qb64.png|'''v1.2'''
File:Qb64.png|'''v1.2'''
Line 21: Line 22:
File:Osx.png|'''no'''
File:Osx.png|'''no'''
</gallery>
</gallery>
<!-- additional availability notes go below here -->




Line 44: Line 46:


{{PageSeeAlso}}
{{PageSeeAlso}}
* [https://qb64phoenix.com/forum/showthread.php?tid=1084 Featured in our "Keyword of the Day" series]
* [[_WINDOWHANDLE]]
* [[_SCREENEXISTS]]
* [[_SCREENEXISTS]]




{{PageNavigation}}
{{PageNavigation}}

Latest revision as of 19:35, 24 May 2024

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


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



Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link