Export (0) Print
Expand All
6 out of 10 rated this helpful - Rate this topic

SetActiveWindow function

Activates a window. The window must be attached to the calling thread's message queue.

Syntax


HWND WINAPI SetActiveWindow(
  _In_  HWND hWnd
);

Parameters

hWnd [in]

Type: HWND

A handle to the top-level window to be activated.

Return value

Type: HWND

If the function succeeds, the return value is the handle to the window that was previously active.

If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

The SetActiveWindow function activates a window, but not if the application is in the background. The window will be brought into the foreground (top of Z-Order) if its application is in the foreground when the system activates the window.

If the window identified by the hWnd parameter was created by the calling thread, the active window status of the calling thread is set to hWnd. Otherwise, the active window status of the calling thread is set to NULL.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
GetActiveWindow
SetForegroundWindow
WM_ACTIVATE
Conceptual
Keyboard Input

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.