Función SetWindowPlacement (winuser.h)
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
Referencia