Função SetWindowPlacement (winuser.h)
Define o estado de exibição e as posições restauradas, minimizadas e maximizadas da janela especificada.
Sintaxe
BOOL SetWindowPlacement(
[in] HWND hWnd,
[in] const WINDOWPLACEMENT *lpwndpl
);
Parâmetros
[in] hWnd
Digite: HWND
Um identificador para a janela.
[in] lpwndpl
Tipo: const WINDOWPLACEMENT*
Um ponteiro para uma estrutura WINDOWPLACEMENT que especifica as novas posições de estado de exibição e janela.
Antes de chamar SetWindowPlacement, defina o membro de comprimento da estrutura WINDOWPLACEMENT como sizeof(WINDOWPLACEMENT). SetWindowPlacement falhará se o membro de comprimento não estiver definido corretamente.
Valor retornado
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
Se as informações especificadas em WINDOWPLACEMENT resultarem em uma janela completamente fora da tela, o sistema ajustará automaticamente as coordenadas para que a janela fique visível, levando em conta as alterações na resolução de tela e na configuração de vários monitores.
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
| 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-3 (introduzido no Windows 10, versão 10.0.10240) |
Confira também
Conceitual
Referência