CGDIRgn Class

class CGDIRgn: public CGDIObject

Defined in: GDIObjects.h

Class Members

CGDIRgn(HRGNh = NULL, bool bOwn = true)

Attach constructor. Initializes a new instance of CGDIRgn and optionally attaches a previously existing bitmap handle. The ownership of this handle is determined by the bOwn parameter.

CGDIRgn(CGDIRgn& rhs, bool bTransferOwnership = true)

Copy constructor. Takes an existing CGDIRgn instance and copies its contents to the new instance being constructed. If the object being copied is the owner of the handle, ownership's transference is controlled by the parameter bTransferOwnership.

CGDIRgn& operator =(CGDIRgn& rhs)

Copies the contents of the passed object into this instance. Ownership is always transfered if it belongs to the object being copied.

bool CreateRectRgn(int x1, int y1, int x2, int y2)

Creates a rectangular region

bool CreateRectRgnIndirect(LPCRECT lpRect)

Creates a rectangular region

bool CreateEllipticRgn(int x1, int y1, int x2, int y2)

Creates an elliptical region

bool CreateEllipticRgnIndirect(LPCRECT lpRect)

Creates an elliptical region

bool CreatePolygonRgn(LPPOINT lpPoints, int nCount, int nMode)

Creates a polygonal region

bool CreatePolyPolygonRgn(LPPOINT lpPoints, LPINT lpPolyCounts, int nCount, int nPolyFillMode)

Creates a polygonal region

bool CreateRoundRectRgn(int x1, int y1, int x2, int y2, int x3, int y3)

Creates a round rectangular region

bool CreateFromPath(HDC hdc)

Creates a region from the path selected in the given DC

bool CreateFromData(const XFORM* lpXForm, int nCount, const RGNDATA* pRgnData)

Creates a region from the given region and transformation data

void SetRectRgn(int x1, int y1, int x2, int y2)

Changes the region to a rectangular region with the specified coordinates

void SetRectRgn(LPCRECT lpRect)

Changes the region to a rectangular region with the specified coordinates

int CombineRgn(CGDIRgn& aRgn1, CGDIRgn& aRgn2, int nCombineMode)

Combines the two given regions using the given combine operation

int CopyRgn(CGDIRgn& aRgnSrc)

Copy the region passed in into this region

bool EqualRgn(CGDIRgn& aRgn) const

Compares the region passed in to this region

int OffsetRgn(int x, int y)

Displaces this region

int OffsetRgn(POINT point)

Displaces this region

int GetRgnBox(LPRECT lpRect) const

Smallest rectangle that contains the entire region

bool PtInRegion(int x, int y) const

Determines whether a given point is contained within this region

bool PtInRegion(POINT point) const

Determines whether a given point is contained within this region

bool RectInRegion(LPCRECT lpRect) const

Determines whether a given rectangle is contained within this region

int GetRegionData(LPRGNDATA lpRgnData, int nCount) const

Returns the region information encapsulated in a RGNDATA parameter