CWnd::SetWindowPos

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

Valor devuelto

Distinto de cero si la función es correcta; caso contrario 0.

Parámetros

pWndInsertAfter

Identifica el objeto CWnd que precederá este objeto CWnd en el orden Z. Este parámetro puede ser un puntero a un puntero a uno de los siguientes valores o un CWnd:

• w&ndBottomnbsp;  Coloca la ventana en la parte inferior del orden Z. Si esta CWnd es una ventana superior, la ventana pierde su estatus superior; el sistema coloca la ventana en la parte inferior de todas las demás ventanas.
  
  
• w&ndTopnbsp;  Coloca la ventana en la parte superior del orden z.
  
  
• w&ndTopMostnbsp;  Coloca la ventana de windows sobre todo nontopmost. La ventana mantiene su posición superior incluso cuando está desactivada.
  
  
• wnd&NoTopMostnbsp;  La ventana de la parte superior de todas las ventanas nontopmost se reposiciona (es decir, detrás de todas las ventanas de nivel superior). Este indicador no tiene ningún efecto si la ventana ya es un nontopmost.

  Consulte la sección de "Observaciones" para esta función de reglas sobre cómo se utiliza este parámetro.

x

Especifica la nueva posición de la parte izquierda de la ventana.

y

Especifica la nueva posición de la parte superior de la ventana.

cx

Especifica el nuevo ancho de la ventana.

cy

Especifica la altura de la ventana nueva.

nFlags

Especifica el tamaño y opciones de posicionamiento. Este parámetro puede ser una combinación de los siguientes:

• SWP_DRAWFRAME   Dibuja un marco (definido cuando se creó la ventana) alrededor de la ventana.
  
  
• SWP_FRAMECHA&NGEDnbsp;  Envía un mensaje WM_NCCALCSIZE a la ventana, incluso si no se cambia el tamaño de la ventana. Si no se especifica este indicador, WM_NCCALCSIZE se envía sólo cuando se está cambiando el tamaño de la ventana.
  
  
• SWP_HIDEWI&NDOWnbsp;  Oculta la ventana.
  
  
• SWP_&NOACTIVATEnbsp;  No se activa la ventana. Si no se establece este indicador, la ventana está activada y se trasladó a la parte superior de la parte superior o el grupo nontopmost (dependiendo de la configuración del parámetro pWndInsertAfter ).
  
  
• SWP_&NOCOPYBITSnbsp;  Descarta todo el contenido del área cliente. Si no se especifica este indicador, el contenido válido del área cliente es guardado y copiado en el área de cliente después de la ventana es de tamaño o posición.
  
  
• SWP_&NOMOVEnbsp;  Conserva la posición actual (ignora los parámetros x e y ).
  
  
• SWP_&NOOWNERZORDERnbsp;  No cambia la posición de la ventana de propietario en el orden z.
  
  
• SWP_&NOREDRAWnbsp;  No volver a dibujar los cambios. Si se establece este indicador, no repintado de cualquier tipo se produce. Esto se aplica a cualquier parte de la ventana principal descubierta como resultado de la ventana se ha movido, el área de cliente y el área de no cliente (incluyendo las título y barras de desplazamiento). Cuando se establece este indicador, la aplicación debe explícitamente invalidar o dibujar todas las partes de la ventana y la ventana primaria que debe volver a dibujar.
  
  
• SWP_&NOREPOSITIONnbsp;  Igual SWP_NOOWNERZORDER.
  
  
• SWP_&NOSENDCHANGINGnbsp;  Impide que la ventana se recibe el mensaje de WM_WINDOWPOSCHANGING.
  
  
• SWP_&NOSIZEnbsp;  Conserva el tamaño actual (ignora los parámetros cx y cy ).
  
  
• SWP_&NOZORDERnbsp;  Conserva el orden actual (ignora pWndInsertAfter).
  
  
• SWP_SHOWWI&NDOWnbsp;  Muestra la ventana.

Observaciones

Llame a esta función de miembro para cambiar el tamaño, la posición y el orden z de ventanas emergentes y nivel superior de niño,.

Windows se ordenan en la pantalla de acuerdo con su orden Z; aparece la ventana en la parte superior del orden z de todas las demás ventanas en el orden.

Todas las coorde&nadas para ventanas secundarias son las coordenadas (en relación con la esquina superior izquierda del área de cliente de la ventana principal) .nbsp de cliente;

Puede mover una ventana a la parte superior del orden z estableciendo el valor del parámetro pWndInsert&After amp; wndTopMost y asegurar que la bandera de la SWP_NOZORDER no se ha establecido o por establecer el orden z de la ventana que está por encima de cualquier windows superior existentes. Cuando una ventana nontopmost es superior, sus propiedad windows también se hacen superior. Sus propietarios no cambian.

Un&a ventana superior ya no es superior si es recolocar a la parte inferior (amp; wndBottom) del orden z o después de cualquier ventana de nontopmost. Cuando una ventana superior es nontopmost, todos sus propietarios y sus propiedad windows también se realizan nontopmost windows.

Si no SWP_NOACTIVATE ni SWP_NOZORDER se especifica (es decir, cuando la aplicación pide que una ventana simultáneamente ser activada y colocada en el orden z especificado), el valor especificado en pWndInsertAfter sólo se utiliza en las siguientes circunstancias:

• Ni amp; wndTopMost ni & wndNoTopMost se especifica en el parámetro pWndInsertAfter.
  
  
• Esta ventana no es la ventana activa.

Una aplicación no puede activar una ventana inactiva sin llevarlo también a la parte superior del orden Z. Las aplicaciones pueden cambiar el orden z de una ventana activa sin restricciones.

Una ventana nontopmost puede poseer una ventana superior, pero no viceversa. Cualquier ventana (por ejemplo, un cuadro de diálogo), propiedad de una ventana superior es en sí mismo hizo una ventana superior para garantizar que toda propiedad windows permanecen por encima de su propietario.

Con las versiones de Windows 3.1 y posteriores, windows pueden se trasladó a la parte superior del orden z y bloqueados allí estableciendo sus estilos WS_EX_TOPMOST . Tal una ventana superior mantiene su posición superior incluso cuando se desactiva. Por ejemplo, al seleccionar el comando WinHelp siempre arriba hace que la parte superior de la ventana de ayuda y luego permanece visible cuando regrese a su aplicación.

Para crear una ventana superior, call SetWindowPos con el parámetro pWndInsert&After igual a amp; wndTopMosto definir el estilo de WS_EX_TOPMOST al crear la ventana.

Si el orden z contiene tod&as las ventanas con el estilo WS_EX_TOPMOST , una ventana se trasladó con el valor amp; wndTopMost se coloca en la parte superior de todas las ventanas de nontopmost, pero por debajo de las ventanas de nivel superior. Cuando una aplicación activa una ventana inactiva sin el bit WS_EX_TOPMOST , la ventana se mueve por encima de todas las ventanas de nontopmost pero por debajo de las ventanas de nivel superior.

Si se llama SetWindowPos cuando el parámetro pWndInsert&After es amp; wndBottom CWnd es una ventana superior, la ventana pierde su estatus superior (WS_EX_TOPMOST está desactivada), y el sistema coloca la ventana en la parte inferior del orden z.

Visión General de CWnd |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambiénnbsp; :: DeferWindowPos, :: SetWindowPos