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
mNo edit summary |
No edit summary |
||
| (5 intermediate revisions by the same user not shown) | |||
| 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}} | ||
<!-- QB64 = a version or none, QBPE = a version or all, Platforms = yes or no --> | |||
<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> | |||
<!-- additional availability notes go below here --> | |||
{{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 | ||
| Line 37: | 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
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