Compartilhar via


GetWindow

Windows Mobile SupportedWindows Embedded CE Supported

9/9/2008

Essa função recupera o identificador para uma janela que tem o relacionamento especificado para a janela especificada. Um remoto aplicativo versão interface (RAPI) dessa função existe, nomeado CeGetWindow (RAPI).

Syntax

HWND GetWindow( 
  HWND hWnd, 
  UINT uCmd 
); 

Parameters

  • hWnd
    [no] Identificador para uma janela. O manipulador de janela recuperados é relativo a esta janela, com base no valor da uCmd parâmetro.
  • uCmd
    [no] Especifica o relacionamento entre a janela especificada e a janela cujo identificador é a serem recuperados. Este parâmetro pode ser uma dos seguinte valores.

    Valor Descrição

    GW_CHILD

    O identificador recuperado identifica o janela filho na parte superior de z-ordem, se a janela especificada é uma janela pai; caso contrário, o identificador recuperado é NULL. A função examina somente janelas filho da janela especificada. Ele não examinar janelas descendentes.

    GW_HWNDFIRST

    O identificador recuperado identifica a janela do mesmo tipo que seja mais alto na z-ordem. Se a janela especificada for uma janela de nível superior, o identificador identifica a janela de nível superior que é mais alta na z-ordem. Se a janela especificada for um janela filho, o identificador identifica o janela irmã que seja mais alto na z-ordem.

    GW_HWNDLAST

    O identificador recuperado identifica a janela do mesmo tipo que seja menor na z-ordem. Se a janela especificada for uma janela de nível superior, o identificador identifica a janela de nível superior que é menor na z-ordem. Se a janela especificada for um janela filho, o identificador identifica o janela irmã que seja menor na z-ordem.

    GW_HWNDNEXT

    O identificador recuperado identifica a janela abaixo a janela especificada na z-ordem. Se a janela especificada for uma janela de nível superior, o identificador identifica a janela superior abaixo a janela especificada. Se a janela especificada for um janela filho, o identificador identifica o janela irmã abaixo a janela especificada.

    GW_HWNDPREV

    O identificador recuperado identifica a janela acima a janela especificada na z-ordem. Se a janela especificada for uma janela de nível superior, o identificador identifica a janela superior acima a janela especificada. Se a janela especificada for um janela filho, o identificador identifica o janela irmã acima a janela especificada.

    GW_OWNER

    O identificador recuperado identifica janela proprietária da janela especificada, se houver algum. Este sinalizador não irá recuperar um janela pai.

Return Value

Um identificador janela indica sucesso. NULL Indica que nenhuma janela existe com o relacionamento especificado para a janela especificada. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Essa função distingue entre somente Windows de alto nível e filho. Janelas mais alto são consideradas de alto nível Windows.

Em Windows CE 1.0, o valor sinalizador GW_OWNER para a uCmd parâmetro só é com suporte para diálogo caixas.

Ao trabalhar com RAPI para Windows CE 1.0 e 1.01, use o PegGetWindow função.

Requirements

Header winuser.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

GetActiveWindow
Windows Functions