LBitmap::BorderRemoveCallBack

#include "ltwrappr.h"

virtual L_INT LBitmap::BorderRemoveCallBack(hRgn, uBorderToRemove, pBoundingRect)

HRGN hRgn;

/* windows region */

L_UINT32 uBorderToRemove;

/* border flag */

PRECT pBoundingRect;

/* pointer to a RECT structure */

Called for each border found by LBitmap::BorderRemove.

Parameter

Description

hRgn

Windows region representing the border to be removed. It is the programmer's responsibility to delete this region (using DeleteObject() when it is no longer needed.

uBorderToRemove

Flag that indicates which border is being processed. Possible values are:

 

Value

Meaning

 

BORDER_LEFT

The left border is being processed.

 

BORDER_TOP

The top border is being processed.

 

BORDER_RIGHT

The right border is being processed.

 

BORDER_BOTTOM

The bottom border is being processed.

pBoundingRect

Pointer to a RECT structure that contains the bounding rectangle of the border being processed.

Returns

SUCCESS_REMOVE

Remove the border.

SUCCESS_NOREMOVE

Do not remove the border.

Otherwise

An error occurred. Refer to Return Codes.

Comments

This function is called once for each border found by LBitmap::BorderRemove. It is called a maximum of four times for each call to the LBitmap::BorderRemove. Return SUCCESS_REMOVE to have the border removed. Return SUCCESS_NOREMOVE to leave the border unchanged. Pass any other value to abort. This value will be the return value of the LBitmap::BorderRemove(). If flags BORDER_IMAGE_UNCHANGED and BORDER_SINGLE_REGION are being used, then the return value of this function affects only the internal single region that contains all the changes.

Required DLLs and Libraries

LTIMG

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:

LBitmap::BorderRemove

Topics:

Cleaning Up 1-Bit Images

Example

For an example, refer to LBitmap::BorderRemove.