GetWindowRect Function ()

Switch View

GetWindowRect Function

GetWindowRect Function

The GetWindowRect function retrieves the dimensions of the bounding rectangle of the specified window. The dimensions are given in screen coordinates that are relative to the upper-left corner of the screen.

Syntax

BOOL GetWindowRect(      
    HWND hWnd,
    LPRECT lpRect
);

Parameters

hWnd
[in] Handle to the window.
lpRect
[out] Pointer to a structure that receives the screen coordinates of the upper-left and lower-right corners of the window.

Return Value

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

In conformance with conventions for the RECT structure, the bottom-right coordinates of the returned rectangle are exclusive. In other words, the pixel at (right, bottom) lies immediately outside the rectangle.

Example

For an example, see Initializing a Dialog Box.

Function Information

Minimum DLL Version user32.dll
Header Declared in Winuser.h, include Windows.h
Import library User32.lib
Minimum operating systems Windows 95, Windows NT 3.1
Unicode Implemented as Unicode version.

Minimum DLL Version	user32.dll
Header	Declared in Winuser.h, include Windows.h
Import library	User32.lib
Minimum operating systems	Windows 95, Windows NT 3.1
Unicode	Implemented as Unicode version.

See Also

Windows Overview, GetClientRect

Tags

: Add a tag

Community Content

Add new content

Annotations

Possible VB9 declaration

Đonny ... Noelle Mallory - MSFT | Edit | Show History

Friend Declare Function GetWindowRect Lib "user32.dll" (ByVal hwnd As Int32, ByRef lpRect As RECT) As Boolean

Usage:
Dim RECT As API.RECT
If API.GetWindowRect(hWnd, RECT) Then
    'Do something on success
Else
    'Error you can Throw New Win32Exception()
End If

Tags

: api (x) declaration (x) vb (x) Add a tag

Flag as ContentBug

VB6 Declaration and usage example

Renaud Bompuis | Edit | Show History

VB6 declaration:

Type RECT
   x1 As Long
   y1 As Long
   x2 As Long
   y2 As Long
End Type
Declare Function GetWindowRect Lib "user32" (ByVal hwnd As Long, rectangle As RECT) As Boolean

MS Access usage example:
How to Determine the Current Screen Resolution: http://support.microsoft.com/?kbid=210106

Tags

: Add a tag

Flag as ContentBug

Doesn't return exactly what you'd expect on Vista with Aero Glass

XenonOfArcticus | Edit | Show History

Per this MSDN thread:
http://social.msdn.microsoft.com/Forums/en-US/windowsuidevelopment/thread/6c1c67a9-5548-4e9b-989f-c7dbac0b1375/

Apps under Vista that are not linked with WINVER=6 will receive a misleading set of values here, that do not account for the extra padding of "glass" pixels Vista Aero applies to the window. This appears to happen even in Aero Basic (without Glass) to retain sizing consistency. The workaround (if you don't want to set WINVER=6) seems to be to dynamically bind to dwmapi.dll and use GetProcAddress() to obtain the DwmGetWindowAttribute() function, and call it with the DWMWA_EXTENDED_FRAME_BOUNDS argument to request the genuine window frame dimensions.

This article:
http://shellrevealed.com/blogs/shellblog/archive/2006/10/12/Frequently-asked-questions-about-the-Aero-Basic-window-frame.aspx
explains the anatomy of the window frame dimensions under Vista (though it only diagrams the Aero Basic anatomy, not the full Aero Glass layout).

Tags

: Add a tag

Flag as ContentBug

ZackFlame ... Thomas Lee | Edit | Show History

[DllImport("user32.dll")]

private static extern bool GetWindowRect(IntPtr hWnd, ref Rectangle rect);

Tags

: c# (x) Add a tag

Flag as ContentBug