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/Medical 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: |
|
Topics: |
Example
For an example, refer to L_LineRemoveBitmap.