Jump to content

WinQueryActiveWindow

From EDM2
Revision as of 16:25, 9 April 2025 by Martini (talk | contribs) (Created page with "This function returns the active window for HWND_DESKTOP, or other parent window. ==Syntax==  WinQueryActiveWindow(hwndParent) ==Parameters== ;hwndParent (HWND) - Input : Parent-window handle for which the active window is required. :;HWND_DESKTOP ::The desktop-window handle that causes this function to return the top-level frame window. :;Other ::Specified parent-window handle. ==Returns== ;hwndActive (HWND) - returns :Active-window handle. :;NULLHANDLE ::No...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This function returns the active window for HWND_DESKTOP, or other parent window.

Syntax

 WinQueryActiveWindow(hwndParent)

Parameters

hwndParent (HWND) - Input
Parent-window handle for which the active window is required.
HWND_DESKTOP
The desktop-window handle that causes this function to return the top-level frame window.
Other
Specified parent-window handle.

Returns

hwndActive (HWND) - returns
Active-window handle.
NULLHANDLE
No window is active
Other
Active-window handle.

Errors

Possible returns from WinGetLastError:

  • PMERR_INVALID_HWND (0x1001) An invalid window handle was specified.

Example Code

#define INCL_WINWINDOWMGR
#include <OS2.H>

HWND hwndActive;

hwndActive = WinQueryActiveWindow(HWND_DESKTOP);

Related Functions