Export (0) Print
Expand All

CRgn::SetRectRgn

Creates a rectangular region.

void SetRectRgn(
   int x1,
   int y1,
   int x2,
   int y2 
);
void SetRectRgn(
   LPCRECT lpRect 
);

Parameters

x1
Specifies the x-coordinate of the upper-left corner of the rectangular region.
y1
Specifies the y-coordinate of the upper-left corner of the rectangular region.
x2
Specifies the x-coordinate of the lower-right corner of the rectangular region.
y2
Specifies the y-coordinate of the lower-right corner of the rectangular region.
lpRect
Specifies the rectangular region. Can be either a pointer to a RECT structure or a CRect object.

Remarks

Unlike CreateRectRgn, however, it does not allocate any additional memory from the local Windows application heap. Instead, it uses the space allocated for the region stored in the CRgn object. This means that the CRgn object must already have been initialized with a valid Windows region before calling SetRectRgn. The points given by x1, y1, x2, and y2 specify the minimum size of the allocated space.

Use this function instead of the CreateRectRgn member function to avoid calls to the local memory manager.

See Also

CRgn Overview | Class Members | Hierarchy Chart | CRgn::CreateRectRgn | SetRectRgn

Show:
© 2014 Microsoft