LBitmapBase::CopyRect

#include "ltwrappr.h"

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

virtual L_INT LBitmapBase::CopyRect(LBitmapSrc, rect)

LBitmapBase& LBitmapSrc;	/* the source class object */
L_INT nCol;	/* the first column */
L_INT nRow;	/* the first row */
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 */

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

Parameter	Description
LBitmapSrc	The source class object from which to copy the bitmap rectangle.
nCol	The first column of the source rectangle.
nRow	The first row of the source rectangle.
uWidth	The width of the rectangle to copy.
uHeight	The height of the rectangle to copy.
rect	The rectangle to be copied.

Returns

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.

Note:	The LBitmapSrc parameter is passed by reference, and is a required parameter.
Note:	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.

See Also

Elements:	LBitmapBase::Copy, LBitmapBase::CopyData, LBitmapBase::CopyHandle, Class Members
Topics:	Raster Image Functions: Copying Images
	Raster Image Functions: Palettes
	Raster Image Functions: Using the Clipboard

Example

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

LBitmapBase MyBitmap, Bitmap2;

MyBitmap.SetFileName(TEXT("image1.cmp"));
MyBitmap.Load();

Bitmap2.CopyRect(MyBitmap,0,0, MyBitmap.GetWidth()/2, MyBitmap.GetHeight()/2);

This is an example for LBitmapBase::CopyRect(LBitmapSrc, rect):

LBitmapBase MyBitmap, Bitmap2;

MyBitmap.SetFileName(TEXT("image1.cmp"));
MyBitmap.Load();

RECT Rect={0,0, MyBitmap.GetWidth()/2, MyBitmap.GetHeight()/2};

Bitmap2.CopyRect(MyBitmap,Rect);