GetWindow

GetWindow função recupera um identificador para uma janela que tem o relacionamento especificado (ordem z ou proprietário) para a janela especificada.

(HWND GetWindow HWND  hWnd, / / identificador para janela originalUINTuCmd / / relacionamento bandeira);
 

Parâmetros

hWnd
Identificador para uma janela. O identificador de janela recuperado é relativo a esta janela, com base no valor do parâmetro uCmd.
uCmd
Especifica a relação entre a janela especificada e a janela cujo identificador é a serem recuperados. Este parâmetro pode ser uma dos seguinte valores:
Valor Significado
GW_CHILD O identificador recuperado identifica a janela de filho na parte superior da ordem Z, se a janela especificada for uma janela pai; caso contrário, o identificador recuperado é NULL. A função examina somente janelas filho da janela especificada. Não examinar janelas descendentes.
GW_ENABLEDPOPUP Windows NT 5.0 e posterior: O identificador recuperado identifica a janela de pop-up habilitado pertencente a janela especificada (a pesquisa usa o primeiro janela encontrada usando GW_HWNDNEXT); caso contrário, se não houver nenhuma janela pop-up habilitado, o identificador recuperado é que a janela especificada.
GW_HWNDFIRSTSE O identificador recuperado identifica a janela do mesmo tipo que seja mais alto na ordem Z. Se a janela especificada for uma janela de nível superior, o identificador identifica a janela de nível superior que seja mais alta na ordem Z. Se a janela especificada for uma janela de alto nível, o identificador identifica a janela de alto nível que seja mais alta na ordem Z. Se a janela especificada for um janela filho, o identificador identifica o janela irmã que seja mais alto na ordem z.
GW_HWNDLASTSE O identificador recuperado identifica a janela do mesmo tipo que é mais baixo na ordem Z. Se a janela especificada for uma janela de nível superior, o identificador identifica a janela de nível superior que é mais baixa na ordem Z. Se a janela especificada for uma janela de alto nível, o identificador identifica a janela de alto nível é mais baixa na ordem Z. Se a janela especificada for um janela filho, o identificador identifica o janela irmã que é mais baixo na ordem z.
GW_HWNDNEXT O identificador recuperado identifica a janela abaixo da janela de especificado na ordem Z. Se a janela especificada for uma janela de nível superior, o identificador identifica a janela de nível superior abaixo da janela especificada. Se a janela especificada for uma janela de alto nível, o identificador identifica a janela de alto nível abaixo da 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 ordem Z. Se a janela especificada for uma janela de nível superior, o identificador identifica a janela de nível superior acima a janela especificada. Se a janela especificada for uma janela de alto nível, o identificador identifica a janela de alto nível 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 a janela do proprietário da janela especificada, se houver.

Retornar valores

Se a função for bem-sucedido, o valor de retorno é um identificador de janela. Se nenhuma janela existe com o relacionamento especificado para a janela especificada, o valor de retorno é NULL. Para informações de erro estendidas get, chamar GetLastError.

Observações

A função EnumChildWindows é mais confiável do que chamar GetWindow em um loop. Um aplicativo que chamadas GetWindow para executar esta tarefa riscos sendo travado em um loop infinito ou fazendo referência a um identificador para uma janela que tenha sido destruído.

Windows CE: No Windows CE, versão 1.0, o valor de sinalizador GW_OWNER para o parâmetro uCmd é suportado somente para caixas de diálogo.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral sobre Windows, funções de janela, EnumChildWindows

Index