In This Topic ▼

LBitmapBase::CopyRect

Summary

Copies a rectangle from the source class object's bitmap.

Syntax

#include "ltwrappr.h"

virtual L_INT LBitmapBase::CopyRect(LBitmapSrc, nCol, nRow, uWidth, uHeight)

virtual L_INT LBitmapBase::CopyRect(LBitmapSrc, rect)

Parameters

LBitmapBase& LBitmapSrc

The source class object from which to copy the bitmap rectangle.

L_INT nCol

The first column of the source rectangle.

L_INT nRow

The first row of the source rectangle.

L_UINT uWidth

The width of the rectangle to copy.

L_UINT uHeight

The height of the rectangle to copy.

RECT& rect

The rectangle to be copied.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Call this function to copy a rectangle from the source class object's bitmap.

Call this function to copy a bitmap rectangle from the source object and create a new bitmap in the calling object.

Notes:

The LBitmapSrc parameter is passed by reference, and is a required parameter.
The rect parameter is passed by reference, and is a required parameter.

Required DLLs and Libraries

LTDIS
LTFIL
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.

Example

This is an example for LBitmapBase::CopyRect(LBitmapSrc, nCol, nRow, uWidth, uHeight):

L_INT LBitmapBase__CopyRectExample() 
{ 
   L_INT nRet; 
   LBitmapBase MyBitmap, Bitmap2; 
 
   MyBitmap.SetFileName(MAKE_IMAGE_PATH(TEXT("image1.cmp"))); 
   nRet =MyBitmap.Load(); 
   if(nRet !=SUCCESS) 
      return nRet; 
 
   nRet =Bitmap2.CopyRect(MyBitmap,0,0, MyBitmap.GetWidth()/2, MyBitmap.GetHeight()/2); 
   if(nRet !=SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
}