LBitmapRgn::GetRgnHandle

#include "ltwrappr.h"

virtual HRGN LBitmapRgn::GetRgnHandle(void);

Creates a Windows region that is a snapshot of the associated class object's bitmap region.

Returns

The Windows region handle used by the class object's bitmap region.

Comments

If you want to assign a region from one bitmap to another, you must use the LBitmapRgn::GetRgnHandle function to get region from the first bitmap; then use the LBitmapRgn::SetRgnHandle function to assign the region to the second bitmap.

You are responsible for deleting the Windows region to free memory when the region is no longer needed. To do so, use the Windows DeleteObject function. The following is a list of Windows functions that relate to Windows regions:

Function	Action
CombineRgn	creates a region by combining two regions.
CreateEllipticRgn	creates an elliptical region.
CreateEllipticRgnIndirect	creates and elliptical region.
CreatePolygonRgn	creates a polygonal region.
CreatePolyPolygonRgn	creates a region consisting of polygons.
CreateRectRgn	creates a rectangular region.
CreateRectRgnIndirect	creates a rectangular region using a RECT structure.
CreateRoundRectRgn	creates a rectangular region with round corners.
DeleteObject	deletes a Windows GDI object, such as a region.
EqualRgn	compares two regions for equality.
FillRgn	fills a region with the specified brush.
FrameRgn	draws a border around a region.
GetRgnBox	retrieves the bounding rectangle for a region.
InvertRgn	inverts the colors in a region.
OffsetRgn	moves a region by the specified offsets.
PaintRgn	fills a region with the brush in the device context.
PtInRegion	queries whether a point is in a region.
RectInRegion	queries whether a rectangle overlaps a region.
SetRectRgn	changes a region into a specified rectangle.

Required DLLs and Libraries

LTDIS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Elements:	LBitmapRgn::SetRgnHandle, Class Members
Topics:	Raster Image Functions: Creating and Using a Region
	Raster Image Functions: Region Processing
	Defining and Using a Bitmap Region