CWnd::SetWindowPos

BOOL SetWindowPos ( const CWnd * pWndInsertAfter, int x, int y, int cx, int cy, UINT nFlags );

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0.

Parâmetros

pWndInsertAfter

Identifica o objeto de CWnd que vai preceder a este objeto CWnd na Z-ordem. Este parâmetro pode ser um ponteiro para um CWnd ou um ponteiro para um dos seguintes valores:

• w&ndBottomnbsp;  Coloca a janela na parte inferior da ordem Z. Se este CWnd é uma janela de nível superior, a janela perde seu status de nível superior; o sistema coloca a janela na parte inferior de todas as outras janelas.
  
  
• w&ndTopnbsp;  Coloca a janela na parte superior da Z-ordem.
  
  
• w&ndTopMostnbsp;  Coloca a janela windows acima de tudo nontopmost. A janela mantém sua posição superior mesmo quando ela é desativada.
  
  
• wnd&NoTopMostnbsp;  Reposiciona a janela para a parte superior de todas as janelas do nontopmost (ou seja, por trás de todas as janelas de nível superior). Este sinalizador não tem efeito se a janela já é um nontopmost.

  Consulte a seção "Comentários" para essa função de regras sobre como este parâmetro é usado.

x

Especifica a Novo posição do Esquerda laterais da janela.

y

Especifica a nova posição da parte superior da janela.

cx

Especifica a Novo largura da janela.

cy

Especifica a Novo altura da janela.

nFlags

Especifica dimensionamento e opções de posicionamento. Este parâmetro pode ser uma combinação dos seguintes:

• SWP_DRAWFRAME   Desenha um quadro (definido quando a janela foi criada) próximo a janela.
  
  
• SWP_FRAMECHA&NGEDnbsp;  Envia uma mensagem WM_NCCALCSIZE à janela, mesmo se o tamanho da janela não está sendo alterado. Se este sinalizador não for especificado, WM_NCCALCSIZE é enviada somente quando o tamanho da janela está sendo alterado.
  
  
• SWP_HIDEWI&NDOWnbsp;  Oculta a janela.
  
  
• SWP_&NOACTIVATEnbsp;  Não ativa a janela. Se este sinalizador não estiver definido, a janela é ativada e mudou-se para a parte superior do nível superior ou do grupo nontopmost (dependendo da configuração do parâmetro pWndInsertAfter ).
  
  
• SWP_&NOCOPYBITSnbsp;  Descarta todo o conteúdo da área cliente. Se este sinalizador não for especificado, o válido conteúdo da área cliente é salvas e copiado voltar para a área cliente depois que a janela for dimensionada ou reposicionada.
  
  
• SWP_&NOMOVEnbsp;  Mantém a posição atual (ignora o x e y parâmetros).
  
  
• SWP_&NOOWNERZORDERnbsp;  Não alterar a posição da janela de proprietário na Z-ordem.
  
  
• SWP_&NOREDRAWnbsp;  Não redesenhar as alterações. Se este sinalizador estiver definido, não redesenho de qualquer espécie ocorre. Isto aplica-se a área do cliente, a área não cliente (incluindo as título e barras de rolagem) e qualquer parte da janela pai descoberta como resultado da janela movida. Quando este sinalizador estiver definido, o aplicativo deve explicitamente invalidar ou redesenhar as partes da janela e a janela pai que deve ser redesenhada.
  
  
• SWP_&NOREPOSITIONnbsp;  Mesmo que SWP_NOOWNERZORDER.
  
  
• SWP_&NOSENDCHANGINGimpedenbsp;  Impede que a janela de recebimento da mensagem WM_WINDOWPOSCHANGING.
  
  
• SWP_&NOSIZEnbsp;  Mantém o tamanho atual (ignora o cx e cy parâmetros).
  
  
• SWP_&NOZORDERnbsp;  Mantém o índice atual (ignora pWndInsertAfter).
  
  
• SWP_SHOWWI&NDOWnbsp;  Exibe a janela.

Observações

Chame essa função de membro para alterar o tamanho, posição e ordem z das janelas de pop-up e nível superior filho,.

Windows são ordenados na tela de acordo com a sua ordem Z; a janela na parte superior da ordem z aparece no topo de todas as outras janelas na ordem.

Todas as coorde&nadas para janelas filho são cliente coordenadas (relativo para o upper-Esquerda canto da área cliente da janela pai) .nbsp;

Uma janela pode ser movida para a parte superior da Z-ordem por configuração o parâmetro pWndInsert&After para amp; wndTopMost e garantir que o sinalizador SWP_NOZORDER não está definido ou definindo Z-ordem de uma janela para que fique acima de quaisquer janelas de nível superior existentes. Quando uma janela de nontopmost é feita na extremidade superior, suas janelas de propriedade são também feitas na extremidade superior. Seus proprietários não são alterados.

Um&a janela de nível superior já não é mais alta se ele é reposicionado para baixo (amp; wndBottom) de Z-ordem ou após qualquer janela nontopmost. Quando uma janela de nível superior é feita nontopmost, todos os seus proprietários e suas janelas de propriedade também são feitos nontopmost windows.

Se nem SWP_NOACTIVATE nem SWP_NOZORDER é especificado (isto é, quando o aplicativo solicita que uma janela ser simultaneamente ativada e colocada na Z-ordem especificada), o valor especificado na pWndInsertAfter é usado somente nas seguintes circunstâncias:

• Amp; wndTopMost nem & wndNoTopMost é especificado no parâmetro pWndInsertAfter.
  
  
• Esta janela não for a janela ativa.

Um aplicativo não é possível ativar uma janela inativa sem também trazê-lo para o topo da ordem Z. Aplicativos podem alteração a Z-ordem de uma janela ativada sem restrições.

Uma janela de nontopmost pode possuir uma janela de nível superior, mas não vice-versa. Qualquer janela (por exemplo, uma caixa de diálogo) pertencente uma janela de nível superior é feita uma janela de nível superior para garantir que todas as propriedade windows ficar acima dos respectivos proprietários.

Com versões do Windows 3.1 e posteriores, windows podem ser movidos para o topo da ordem z e bloqueados lá, definindo seu estilo WS_EX_TOPMOST . Uma janela de nível superior mantém sua posição superior mesmo quando desativada. Por exemplo, selecionando o comando de WinHelp sempre visível faz com que a janela da ajuda na extremidade superior e depois permanece visível quando você retornar ao seu aplicativo.

Para criar uma janela de nível superior, chamar SetWindowPos com o parâmetro de pWndInsert&After igual ao amp; wndTopMostou definir o estilo WS_EX_TOPMOST quando você cria a janela.

Se &a ordem z contém todas as janelas com o estilo WS_EX_TOPMOST , uma janela mudou-se com o amp; wndTopMost valor é colocada na parte superior de todas as janelas nontopmost, mas abaixo de qualquer janelas de nível superior. Quando um aplicativo ativa uma janela inativa sem o bit WS_EX_TOPMOST , a janela é movida acima todas as janelas do nontopmost mas abaixo qualquer janelas de nível superior.

Se SetWindowPos é chamado quando o parâmetro pWndInsert&After é amp; wndBottom CWnd é uma janela de nível superior, a janela perde seu status de nível superior (WS_EX_TOPMOST está desmarcada) e o sistema coloca a janela na parte inferior da ordem z.

|&Nbsp CWnd visão geral ; Membros de classe | Gráfico de hierarquia

Consulte tambémnbsp; :: DeferWindowPos, :: SetWindowPos