Função GetWindow (winuser.h)
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 |
|---|---|
|
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. |
|
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. |
|
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ã. |
|
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ã. |
|
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ã. |
|
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ã. |
|
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
Referência