LBitmapRgn::SetRgnRect

#include "ltwrappr.h"

virtual L_INT LBitmapRgn::SetRgnRect(pRect)

LPRECT pRect;

/* pointer to the windows RECT structure */

Creates or updates the associated class object's bitmap region by adding a rectangular region.

Parameter

Description

pRect

Pointer to the windows RECT structure that specifies the rectangular region. You specify the structure using device context coordinates, and LEADTOOLS translates the coordinates using the values set using LBitmapRgn::SetRgnXForm.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

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.

Platforms

Win32, x64.

See Also

Functions:

LBitmapRgn::SetRgnColor, LBitmapRgn::SetRgnEllipse, LBitmapRgn::SetRgnPolygon, LBitmapRgn::SetRgnRoundRect, 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

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName
L_INT LBitmapRgn__SetRgnRectExample()
{
   L_INT nRet;
   LBitmapBase MyBitmap;
   RECT Rect={10,10,50,200};
   
   nRet = MyBitmap.Load(MAKE_IMAGE_PATH(TEXT("image1.cmp")));
   if(nRet !=SUCCESS)
      return nRet;
   LBitmapRgn Region(&MyBitmap);
   nRet =Region.SetRgnRect(&Rect);
   if(nRet !=SUCCESS)
      return nRet;
 //set the rect as a region
   //…
   return SUCCESS;
}