Função GetWindowPlacement (winuser.h)

  • Artigo

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

SetWindowPlacement

WINDOWPLACEMENT

Windows