Función GetWindowRect (winuser.h)

Artículo
08/27/2023

Recupera las dimensiones del rectángulo delimitador de la ventana especificada. Las dimensiones se proporcionan en coordenadas de pantalla relativas a la esquina superior izquierda de la pantalla.

Sintaxis

BOOL GetWindowRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect
);

Parámetros

[in] hWnd

Tipo: HWND

Un identificador de la ventana.

[out] lpRect

Tipo: LPRECT

Puntero a una estructura RECT que recibe las coordenadas de pantalla de las esquinas superior izquierda e inferior derecha de la ventana.

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

Conforme a las convenciones de la estructura RECT , las coordenadas inferior derecha del rectángulo devuelto son exclusivas. En otras palabras, el píxel situado en (derecha, inferior) se encuentra inmediatamente fuera del rectángulo.

GetWindowRect está virtualizado para PPP.

En Windows Vista y versiones posteriores, window Rect ahora incluye el área ocupada por la sombra de colocación.

Llamar a GetWindowRect tendrá un comportamiento diferente en función de si la ventana se ha mostrado o no. Si la ventana no se ha mostrado antes, GetWindowRect no incluirá el área de la sombra de colocación.

Para obtener los límites de la ventana excepto la sombra de colocación, use DwmGetWindowAttribute y especifique DWMWA_EXTENDED_FRAME_BOUNDS. Tenga en cuenta que, a diferencia de Window Rect, los límites de fotograma extendido de DWM no se ajustan para PPP. La obtención de los límites de fotograma extendidos solo se puede realizar después de que la ventana se haya mostrado al menos una vez.

Ejemplos

Para obtener un ejemplo, vea Inicializar un cuadro de diálogo.

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-0 (introducido en Windows 8)