CreateRectRgnIndirect function

The CreateRectRgnIndirect function creates a rectangular region.

Syntax


HRGN CreateRectRgnIndirect(
  _In_ const RECT *lprc
);

Parameters

lprc [in]

Pointer to a RECT structure that contains the coordinates of the upper-left and lower-right corners of the rectangle that defines the region in logical units.

Return value

If the function succeeds, the return value is the handle to the region.

If the function fails, the return value is NULL.

Remarks

When you no longer need the HRGN object, call the DeleteObject function to delete it.

Region coordinates are represented as 27-bit signed integers.

The region will be exclusive of the bottom and right edges.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Regions Overview
Region Functions
CreatePolygonRgn
CreatePolyPolygonRgn
CreateRectRgn
CreateRoundRectRgn
ExtCreateRegion
GetRegionData
DeleteObject
RECT
SelectObject

 

 

Show: