SetForegroundWindow_I (Windows Embedded CE 6.0)

1/6/2010

This function puts the thread that created the specified window into the foreground and activates the window.

Syntax

BOOL WINAPI SetForegroundWindow_I(
  HWND hwnd
);

Parameters

• hwnd
  [in] Handle to the window that you want to activate and bring to the foreground.

Return Value

A nonzero value indicates that SetForegroundWindow_I successfully brought the window to the foreground. Zero indicates that SetForegroundWindow_I did not bring the window to the foreground.

Remarks

The foreground window is the window at the top of the z-order. The foreground window is also the window with which the user is working. In a pre-emptive multitasking environment, you should generally let the user control which window becomes the foreground window.

The thread that owns the window does not receive an increased priority.

Requirements

See Also

Reference

GWES OS Functions
GetForegroundWindow_I
SetActiveWindow
SetForegroundWindow