Função GetWindowPlacement (winuser.h)
Recupera o estado de exibição e as posições restauradas, minimizadas e maximizadas da janela especificada.
Sintaxe
BOOL GetWindowPlacement(
[in] HWND hWnd,
[in, out] WINDOWPLACEMENT *lpwndpl
);
Parâmetros
[in] hWnd
Digite: HWND
Um identificador para a janela.
[in, out] lpwndpl
Tipo: WINDOWPLACEMENT*
Um ponteiro para a estrutura WINDOWPLACEMENT que recebe as informações de estado de exibição e posição. Antes de chamar GetWindowPlacement, defina o membro de comprimento como sizeof(WINDOWPLACEMENT).
GetWindowPlacement falhará se lpwndpl-length> não estiver definido corretamente.
Retornar valor
Tipo: BOOL
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
O membro flags de WINDOWPLACEMENT recuperado por essa função é sempre zero. Se a janela identificada pelo parâmetro hWnd for maximizada, o membro showCmd será SW_SHOWMAXIMIZED. Se a janela for minimizada, showCmd será SW_SHOWMINIMIZED. Caso contrário, será SW_SHOWNORMAL.
O membro de comprimento de WINDOWPLACEMENT deve ser definido como sizeof(WINDOWPLACEMENT). Se esse membro não estiver definido corretamente, a função retornará FALSE. Para obter comentários adicionais sobre o uso adequado das coordenadas de posicionamento da janela, consulte WINDOWPLACEMENT.
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