CreateRectRgnIndirect function (wingdi.h)

The CreateRectRgnIndirect function creates a rectangular region.

Syntax

HRGN CreateRectRgnIndirect(
  [in] const RECT *lprect
);

Parameters

[in] lprect

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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See also

CreatePolyPolygonRgn

CreatePolygonRgn

CreateRectRgn

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

RECT

Region Functions

Regions Overview

SelectObject