Export (0) Print
Expand All

GetWindow (Windows CE 5.0)

Windows CE 5.0
Send Feedback

This function retrieves the handle to a window that has the specified relationship to the specified window. A remote application interface (RAPI) version of this function exists, named CeGetWindow (RAPI).

HWND GetWindow( 
  HWND hWnd, 
  UINT uCmd 
); 

Parameters

hWnd
[in] Handle to a window. The window handle retrieved is relative to this window, based on the value of the uCmd parameter.
uCmd
[in] Specifies the relationship between the specified window and the window whose handle is to be retrieved. This parameter can be one of the following values.
ValueDescription
GW_CHILDThe retrieved handle identifies the child window at the top of the z-order, if the specified window is a parent window; otherwise, the retrieved handle is NULL. The function examines only child windows of the specified window. It does not examine descendant windows.
GW_HWNDFIRSTThe retrieved handle identifies the window of the same type that is highest in the z-order. If the specified window is a topmost window, the handle identifies the topmost window that is highest in the z-order. If the specified window is a child window, the handle identifies the sibling window that is highest in the z-order.
GW_HWNDLASTThe retrieved handle identifies the window of the same type that is lowest in the z-order. If the specified window is a topmost window, the handle identifies the topmost window that is lowest in the z-order. If the specified window is a child window, the handle identifies the sibling window that is lowest in the z-order.
GW_HWNDNEXTThe retrieved handle identifies the window below the specified window in the z-order. If the specified window is a topmost window, the handle identifies the topmost window below the specified window. If the specified window is a child window, the handle identifies the sibling window below the specified window.
GW_HWNDPREVThe retrieved handle identifies the window above the specified window in the z-order. If the specified window is a topmost window, the handle identifies the topmost window above the specified window. If the specified window is a child window, the handle identifies the sibling window above the specified window.
GW_OWNERThe retrieved handle identifies the specified window's owner window, if any. This flag will not retrieve a parent window.

Return Values

A window handle indicates success. NULL indicates that no window exists with the specified relationship to the specified window. To get extended error information, call GetLastError.

Remarks

This function distinguishes between only top-level and child windows. Top-most windows are considered top-level windows.

In Windows CE 1.0, the GW_OWNER flag value for the uCmd parameter is only supported for dialog boxes.

When working with RAPI for Windows CE 1.0 and 1.01, use the PegGetWindow function.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.

See Also

GetActiveWindow | Windows Functions


Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.


Show:
© 2014 Microsoft