Estructura WINDOWPLACEMENT (winuser.h)

Artículo
08/28/2023

Contiene información sobre la colocación de una ventana en la pantalla.

Sintaxis

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

Miembros

length

Tipo: UINT

Longitud de la estructura, en bytes. Antes de llamar a las funciones GetWindowPlacement o SetWindowPlacement , establezca este miembro en sizeof(WINDOWPLACEMENT).

Se produce un error en GetWindowPlacement y SetWindowPlacement si este miembro no está configurado correctamente.

flags

Tipo: UINT

Marcas que controlan la posición de la ventana minimizada y el método por el que se restaura la ventana. Este miembro puede ser uno o varios de los valores siguientes.

Value	Significado
WPF_ASYNCWINDOWPLACEMENT 0x0004	Si el subproceso que realiza la llamada y el subproceso propietario de la ventana se adjuntan a diferentes colas de entrada, el sistema envía la solicitud al subproceso que posee la ventana. Esto impide que el subproceso que realiza la llamada bloquee su ejecución mientras otros subprocesos procesan la solicitud.
WPF_RESTORETOMAXIMIZED 0x0002	La ventana restaurada se maximizará, independientemente de si se ha maximizado antes de que se minimice. Esta configuración solo es válida la próxima vez que se restaure la ventana. No cambia el comportamiento de restauración predeterminado. Esta marca solo es válida cuando se especifica el valor SW_SHOWMINIMIZED para el miembro showCmd .
WPF_SETMINPOSITION 0x0001	Se pueden especificar las coordenadas de la ventana minimizada. Esta marca debe especificarse si las coordenadas se establecen en el miembro ptMinPosition .

showCmd

Tipo: UINT

Estado de presentación actual de la ventana. Puede ser cualquiera de los valores que se pueden especificar en el parámetro nCmdShow para la función ShowWindow.

ptMinPosition

Tipo: POINT

Coordenadas de la esquina superior izquierda de la ventana cuando se minimiza la ventana.

ptMaxPosition

Tipo: POINT

Coordenadas de la esquina superior izquierda de la ventana cuando se maximiza la ventana.

rcNormalPosition

Tipo: RECT

Las coordenadas de la ventana cuando la ventana está en la posición restaurada.

rcDevice

Observaciones

Si la ventana es una ventana de nivel superior que no tiene el estilo de ventana de WS_EX_TOOLWINDOW , las coordenadas representadas por los miembros siguientes están en coordenadas del área de trabajo: ptMinPosition, ptMaxPosition y rcNormalPosition. De lo contrario, estos miembros están en coordenadas de pantalla.

Las coordenadas del área de trabajo difieren de las coordenadas de pantalla en que toman en cuenta las ubicaciones y tamaños de las barras de herramientas de la aplicación (incluida la barra de tareas). La coordenada del área de trabajo (0,0) es la esquina superior izquierda del área de trabajo, el área de la pantalla que no usan las barras de herramientas de la aplicación.

Las coordenadas usadas en una estructura WINDOWPLACEMENT solo se deben usar en las funciones GetWindowPlacement y SetWindowPlacement . Pasar coordenadas del área de trabajo a funciones que esperan coordenadas de pantalla (como SetWindowPos) dará lugar a que la ventana aparezca en la ubicación incorrecta. Por ejemplo, si la barra de tareas está en la parte superior de la pantalla, guardar las coordenadas de la ventana mediante GetWindowPlacement y restaurarlas mediante SetWindowPos hace que la ventana aparezca como "espeluznante" en la pantalla.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	winuser.h (incluya Windows.h)