Função GetWindow (winuser.h)

  • Artigo

Recupera um identificador para uma janela que tem a relação especificada (Ordem Z ou proprietário) com a janela especificada.

Sintaxe

HWND GetWindow(
  [in] HWND hWnd,
  [in] UINT uCmd
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para uma janela. O identificador de janela recuperado é relativo a essa janela, com base no valor do parâmetro uCmd .

[in] uCmd

Tipo: UINT

A relação entre a janela especificada e a janela cujo identificador deve ser recuperado. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
GW_CHILD
5
 O identificador recuperado identifica a janela filho na parte superior da ordem Z, se a janela especificada for uma janela pai; caso contrário, o identificador recuperado será NULL. A função examina apenas janelas filho da janela especificada. Ele não examina janelas descendentes.
GW_ENABLEDPOPUP
6
 O identificador recuperado identifica a janela pop-up habilitada pertencente à janela especificada (a pesquisa usa a primeira janela desse tipo encontrada usando GW_HWNDNEXT); caso contrário, se não houver janelas pop-up habilitadas, o identificador recuperado será o da janela especificada.
GW_HWNDFIRST
0
 O identificador recuperado identifica a janela do mesmo tipo que é mais alta na ordem Z.

Se a janela especificada for uma janela superior, o identificador identificará uma janela superior. Se a janela especificada for uma janela de nível superior, o identificador identificará uma janela de nível superior. Se a janela especificada for uma janela filho, o identificador identificará uma janela irmã.
GW_HWNDLAST
1
 O identificador recuperado identifica a janela do mesmo tipo que é mais baixa na ordem Z.

Se a janela especificada for uma janela superior, o identificador identificará uma janela superior. Se a janela especificada for uma janela de nível superior, o identificador identificará uma janela de nível superior. Se a janela especificada for uma janela filho, o identificador identificará uma janela irmã.
GW_HWNDNEXT
2
 O identificador recuperado identifica a janela abaixo da janela especificada na ordem Z.

Se a janela especificada for uma janela superior, o identificador identificará uma janela superior. Se a janela especificada for uma janela de nível superior, o identificador identificará uma janela de nível superior. Se a janela especificada for uma janela filho, o identificador identificará uma janela irmã.
GW_HWNDPREV
3
 O identificador recuperado identifica a janela acima da janela especificada na ordem Z.

Se a janela especificada for uma janela superior, o identificador identificará uma janela superior. Se a janela especificada for uma janela de nível superior, o identificador identificará uma janela de nível superior. Se a janela especificada for uma janela filho, o identificador identificará uma janela irmã.
GW_OWNER
4
 O identificador recuperado identifica a janela de proprietário da janela especificada, se houver. Para obter mais informações, consulte Windows de propriedade.

Retornar valor

Digite: HWND

Se a função for bem-sucedida, o valor retornado será um identificador de janela. Se nenhuma janela existir com a relação especificada com a janela especificada, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função EnumChildWindows é mais confiável do que chamar GetWindow em um loop. Um aplicativo que chama GetWindow para executar essa tarefa corre o risco de ser pego em um loop infinito ou referenciar um identificador para uma janela que foi destruída.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-window-l1-1-0 (introduzido em Windows 8)

Confira também

Conceitual

EnumChildWindows

Referência

Windows