LINEREMOVECALLBACK Function

#include "l_bitmap.h"

L_INT pEXT_CALLBACK Your Function(hRgn, iStartRow, iStartCol, iLength, pUserData)

HRGN hRgn;

/* windows region */

L_INT iStartRow;

/* starting row */

L_INT iStartCol;

/* starting column */

L_INT iLength;

/* line length */

L_VOID* pUserData;

/* pointer to additional parameters */

Handles each line found by L_LineRemoveBitmap.

This function is available in the Document and Medical Imaging toolkits.

Parameter

Description

hRgn

Windows region representing a line to be removed. It is the programmers responsibility to delete this region, using DeleteObject() when it is no longer needed.

iStartRow

The starting row of the line. The rows are zero-based.

iStartCol

The starting column of the line. The columns are zero-based.

iLength

Length (in pixels) of the line.

pUserData

A void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of L_LineRemoveBitmap)

 

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

SUCCESS_REMOVE

Remove the line.

SUCCESS_NOREMOVE

Do not remove the line.

Otherwise

An error occurred. Refer to Return Codes.

Comments

The callback is called for each line found. Return SUCCESS_REMOVE to have the line removed. Return SUCCESS_NOREMOVE to leave the line unchanged. Pass any other value to abort. This value will be the return value of the L_LineRemoveBitmap(). If flags LINE_IMAGE_UNCHANGED and LINE_SINGLE_REGION are being used, then the return value of the callback affects the internal single region that contains all the changes.

Required DLLs and Libraries

LTIMGCOR

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:

L_LineRemoveBitmap

Topics:

Cleaning Up 1-Bit Images

Example

For an example, refer to L_LineRemoveBitmap.