Estrutura WINDOWPLACEMENT (winuser.h)

Artigo
03/15/2023

Contém informações sobre o posicionamento de uma janela na tela.

Sintaxe

typedef struct tagWINDOWPLACEMENT {
  UINT  length;
  UINT  flags;
  UINT  showCmd;
  POINT ptMinPosition;
  POINT ptMaxPosition;
  RECT  rcNormalPosition;
  RECT  rcDevice;
} WINDOWPLACEMENT;

Membros

length

Tipo: UINT

O comprimento da estrutura, em bytes. Antes de chamar as funções GetWindowPlacement ou SetWindowPlacement , defina esse membro como sizeof(WINDOWPLACEMENT).

GetWindowPlacement e SetWindowPlacement falharão se esse membro não estiver definido corretamente.

flags

Tipo: UINT

Os sinalizadores que controlam a posição da janela minimizada e o método pelo qual a janela é restaurada. Esse membro pode ser um ou mais dos valores a seguir.

Valor	Significado
WPF_ASYNCWINDOWPLACEMENT 0x0004	Se o thread de chamada e o thread que possui a janela estiverem anexados a filas de entrada diferentes, o sistema postará a solicitação no thread que possui a janela. Isso impede que o thread de chamada bloqueie sua execução enquanto outros threads processam a solicitação.
WPF_RESTORETOMAXIMIZED 0x0002	A janela restaurada será maximizada, independentemente de ter sido maximizada antes de ser minimizada. Essa configuração só será válida na próxima vez que a janela for restaurada. Ele não altera o comportamento de restauração padrão. Esse sinalizador só é válido quando o valor de SW_SHOWMINIMIZED é especificado para o membro showCmd .
WPF_SETMINPOSITION 0x0001	As coordenadas da janela minimizada podem ser especificadas. Esse sinalizador deverá ser especificado se as coordenadas forem definidas no membro ptMinPosition .

showCmd

Tipo: UINT

O estado de exibição atual da janela. Qualquer um dos valores que podem ser especificados no parâmetro nCmdShow para a função ShowWindow.

ptMinPosition

Tipo: POINT

As coordenadas do canto superior esquerdo da janela quando a janela é minimizada.

ptMaxPosition

Tipo: POINT

As coordenadas do canto superior esquerdo da janela quando a janela é maximizada.

rcNormalPosition

Tipo: RECT

As coordenadas da janela quando a janela está na posição restaurada.

rcDevice

Comentários

Se a janela for uma janela de nível superior que não tenha o estilo de janela WS_EX_TOOLWINDOW , as coordenadas representadas pelos seguintes membros estarão nas coordenadas do workspace: ptMinPosition, ptMaxPosition e rcNormalPosition. Caso contrário, esses membros estão nas coordenadas da tela.

As coordenadas do workspace diferem das coordenadas da tela, pois elas levam em conta os locais e tamanhos das barras de ferramentas do aplicativo (incluindo a barra de tarefas). A coordenada do workspace (0,0) é o canto superior esquerdo da área do workspace, a área da tela que não está sendo usada pelas barras de ferramentas do aplicativo.

As coordenadas usadas em uma estrutura WINDOWPLACEMENT devem ser usadas apenas pelas funções GetWindowPlacement e SetWindowPlacement . Passar coordenadas do workspace para funções que esperam coordenadas de tela (como SetWindowPos) resultará na janela aparecendo no local errado. Por exemplo, se a barra de tarefas estiver na parte superior da tela, salvar coordenadas de janela usando GetWindowPlacement e restaurá-las usando SetWindowPos fará com que a janela pareça "rastejar" para cima na tela.

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]
Cabeçalho	winuser.h (inclua Windows.h)