WINDOWPLACEMENT

A estrutura WINDOWPLACEMENT contém informações sobre o posicionamento de uma janela na tela.

typedef struct _WINDOWPLACEMENT {comprimento UINT; 
    UINT sinalizadores; 
    UINT showCmd; 
    PONTO ptMinPosition; 
    PONTO de ptMaxPosition; 
    RECT rcNormalPosition; 
} WINDOWPLACEMENT 

 

Membros

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

GetWindowPlacement e SetWindowPlacement falharem se esse membro não está definido corretamente.

sinalizadores
Especifica os sinalizadores que Controlaram a posição da janela minimizada e o método pelo qual a janela é restaurada. Esse membro pode ser um ou ambos dos seguintes valores:
Valor Significado
WPF_RESTORETOMAXIMIZED
Especifica que a janela restaurada será ser maximizada, independentemente de saber se ele foi maximizado antes ele foi minimizado. Essa configuração só é válida na próxima vez que a janela é restaurada. Ele não altera o comportamento de restauração padrão. Este sinalizador é válido somente quando o valor SW_SHOWMINIMIZED é especificado para o membro de showCmd.
WPF_SETMINPOSITION
Especifica que as coordenadas de janela minimizada podem ser especificadas. Esse sinalizador deve ser especificado se as coordenadas são definidas no membro ptMinPosition.

showCmd
Especifica o atual estado de apresentação da janela. Esse membro pode ser uma dos seguinte valores:
Valor Significado
SW_HIDE Oculta a janela e ativa outra janela.
SW_MINIMIZE Minimiza a janela especificada e ativa a janela de nível superior na lista do sistema.
SW_RESTORE Ativa e exibe uma janela. Se a janela está minimizada ou maximizada, o sistema restaura-la para seu tamanho original e a posição (mesmo que SW_SHOWNORMAL).
SW_SHOW Ativa uma janela e exibe-o em seu tamanho atual e a posição.
SW_SHOWMAXIMIZED Ativa uma janela e exibe-lo como uma janela maximizada.
SW_SHOWMINIMIZED Ativa uma janela e exibe-lo como um ícone.
SW_SHOWMINNOACTIVE Exibe uma janela como um ícone. A janela ativa permanece ativa.
SW_SHOWNA Exibe uma janela em seu estado atual. A janela ativa permanece ativa.
SW_SHOWNOACTIVATE Exibe uma janela em seu tamanho e posição mais recentes. A janela ativa permanece ativa.
SW_SHOWNORMAL Ativa e exibe uma janela. Se a janela está minimizada ou maximizada, o sistema restaura-la para seu tamanho original e a posição (mesmo que SW_RESTORE).

ptMinPosition
Especifica as coordenadas do canto superior esquerdo da janela quando a janela está minimizada.
ptMaxPosition
Especifica as coordenadas do canto superior esquerdo da janela quando a janela está maximizada.
rcNormalPosition
Especifica as coordenadas da janela quando a janela é na posição restaurada.

Observações

Se a janela é uma janela de alto nível que não tem o estilo de janela WS_EX_TOOLWINDOW e, em seguida, as coordenadas representadas pelos deputados estão em coordenadas de espaço de trabalho: ptMinPosition, ptMaxPositione rcNormalPosition. Caso contrário, esses membros estão em coordenadas da tela.

Coordenadas de espaço de trabalho diferem em coordenadas da tela em que tomam em consideração os locais e tamanhos de appbars (incluindo a barra de tarefas). Espaço de trabalho coordenar (0,0) é o canto superior esquerdo da "área de espaço de trabalho", a área da tela não está sendo usada por appbars.

As coordenadas usadas em uma estrutura WINDOWPLACEMENT devem ser usadas somente por funções GetWindowPlacement e SetWindowPlacement . Passar coordenadas de espaço de trabalho para funções que esperam que as coordenadas de tela (tal como SetWindowPos) resultará na janela que aparece no local errado. Por exemplo, se a barra de tarefas está no topo da tela, salvar janela coordenadas utilizando GetWindowPlacement e restaurá-los usando SetWindowPos causa a janela aparecer para "creep" acima da tela.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Sem suporte.
Cabeçalho:Declarado em WinUser. h.

Ver também

Visão geral sobre Windows, janela estruturas, GetWindowPlacement, SetWindowPlacement, SetWindowPos, ShowWindow, ponto, RECT

Index