Share via

GweBypassCoredllThunk_t::GetWindow_I (Windows Embedded CE 6.0)

  • Article

1/6/2010

This method retrieves the handle to a window that has the specified relationship to the specified window.

Syntax

static HWND WINAPI GetWindow_I(
  HWND hwndThis,
  UINT32 relation
);

Parameters

  • hwndThis
    [in] Handle to a window. The window handle retrieved is relative to this window, based on the value of the relation parameter.

  • relation
    [in] Unsigned integer that specifies the relationship between the specified window and the window whose handle is to be retrieved. The following table shows the possible values.

    Value Description

    GW_CHILD

    The 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 method examines only child windows of the specified window. The method does not examine descendant windows.

    GW_HWNDFIRST

    The 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_HWNDLAST

    The 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_HWNDNEXT

    The 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_HWNDPREV

    The 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_OWNER

    The retrieved handle identifies the owner window for the specified window, if any. This flag does not retrieve a parent window.

Return Value

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 method is an internal version of the GetWindow function.

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

Requirements

Header gwebypasscoredllthunk.hpp
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

GweBypassCoredllThunk_t
GetActiveWindow
GetWindow