Función SetWindowPlacement (winuser.h)

  • Artículo

Establece el estado de presentación y las posiciones restauradas, minimizadas y maximizadas de la ventana especificada.

Sintaxis

BOOL SetWindowPlacement(
  [in] HWND                  hWnd,
  [in] const WINDOWPLACEMENT *lpwndpl
);

Parámetros

[in] hWnd

Tipo: HWND

Un identificador de la ventana.

[in] lpwndpl

Tipo: const WINDOWPLACEMENT*

Puntero a una estructura WINDOWPLACEMENT que especifica las nuevas posiciones de estado de presentación y ventana.

Antes de llamar a SetWindowPlacement, establezca el miembro length de la estructura WINDOWPLACEMENT en sizeof(WINDOWPLACEMENT). Se produce un error en SetWindowPlacement si el miembro length no se ha ajustado correctamente.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si la información especificada en WINDOWPLACEMENT daría lugar a una ventana que está completamente fuera de la pantalla, el sistema ajustará automáticamente las coordenadas para que la ventana sea visible, teniendo en cuenta los cambios en la resolución de pantalla y en la configuración de varios monitores.

El miembro length de WINDOWPLACEMENT debe establecerse en sizeof(WINDOWPLACEMENT). Si este miembro no se establece correctamente, la función devuelve FALSE. Para obtener comentarios adicionales sobre el uso adecuado de las coordenadas de colocación de ventanas, consulte WINDOWPLACEMENT.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-window-l1-1-3 (introducido en Windows 10, versión 10.0.10240)

Consulte también

Conceptual

GetWindowPlacement

Referencia

WINDOWPLACEMENT

Windows