Compartilhar via


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

GetWindowPlacement

Referência

WINDOWPLACEMENT

Windows