LBitmapRgn::SetRgnHandle

#include "ltwrappr.h"

virtual L_INT LBitmapRgn::SetRgnHandle(hRgn)

HRGN hRgn;

/* handle to the Windows region */

Creates or updates the associated class object's bitmap region by adding a region that is specified by a Windows region handle.

Parameter

Description

hRgn

Handle to the Windows region.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The device coordinates are the ones that were in effect at the time the Windows region was created.

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.

To update an existing region, you specify how the new region is to be combined with the existing one. For descriptions of the possibilities, refer to Creating a Bitmap Region.

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.

See Also

Functions:

LBitmapRgn::GetRgnHandle, LBitmapRgn::SetRgnColorHSVRange, LBitmapRgn::SetRgnColorRGBRange, Class Members

Topics:

Raster Image Functions: Creating and Using a Region

 

Raster Image Functions: Region Processing

 

Defining and Using a Bitmap Region

 

Saving a Region

Example

For an example, refer to LBitmapRgn::SetRgnPolygon.