Función GetWindowPlacement (winuser.h)
Recupera el estado show y las posiciones restauradas, minimizadas y maximizadas de la ventana especificada.
Sintaxis
BOOL GetWindowPlacement(
[in] HWND hWnd,
[in, out] WINDOWPLACEMENT *lpwndpl
);
Parámetros
[in] hWnd
Tipo: HWND
Un identificador de la ventana.
[in, out] lpwndpl
Tipo: WINDOWPLACEMENT*
Puntero a la estructura WINDOWPLACEMENT que recibe la información de posición y estado de presentación. Antes de llamar a GetWindowPlacement, establezca el miembro length en sizeof(WINDOWPLACEMENT).
GetWindowPlacement produce un error si lpwndpl-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
El miembro flags de WINDOWPLACEMENT recuperado por esta función siempre es cero. Si la ventana identificada por el parámetro hWnd está maximizada, el miembro showCmd se SW_SHOWMAXIMIZED. Si la ventana está minimizada, showCmd se SW_SHOWMINIMIZED. De lo contrario, es SW_SHOWNORMAL.
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
| Requisito | Value |
|---|---|
| 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-0 (introducido en Windows 8) |
Consulte también
Conceptual
Referencia