WINDOWHASFOCUS: Difference between revisions
Jump to navigation
Jump to search
Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link
No edit summary |
No edit summary |
||
| Line 9: | Line 9: | ||
{{PageDescription}} | {{PageDescription}} | ||
* 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). | * 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). | ||
* '''[[ | * '''[[Keywords currently not supported by QB64#Keywords not supported in Linux or macOS versions|Keyword not supported in macOS versions]]''' | ||
== | {{PageAvailability}} | ||
<gallery widths="48px" heights="48px" mode="nolines"> | |||
File:Qb64.png|'''v1.2''' | |||
File:Qbpe.png|'''all''' | |||
File:Apix.png | |||
File:Win.png|'''yes''' | |||
File:Lnx.png|'''yes''' | |||
File:Osx.png|'''no''' | |||
</gallery> | |||
{{PageExamples}} | {{PageExamples}} | ||
''Example:'' Detecting if the current program has focus. Windows and Linux-only. | ''Example:'' Detecting if the current program has focus. Windows and Linux-only. | ||
{{CodeStart}} | {{CodeStart}} | ||
{{Cl|DO}} | {{Cl|DO}} | ||
{{Cl|IF}} {{Cl|_WINDOWHASFOCUS}} THEN | {{Cl|IF}} {{Cl|_WINDOWHASFOCUS}} THEN | ||
Revision as of 02:59, 23 January 2023
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