INVERTEDTEXTCALLBACK Function
#include "l_bitmap.h"
L_INT pEXT_CALLBACK YourFunction(hRgn, pBoundingRect, iWhiteCount, iBlackCount, pUserData)
|
HRGN hRgn; |
/* windows region */ |
|
PRECT pBoundingRect; |
/* pointer to a RECT structure */ |
|
L_INT32 iWhiteCount; |
/* number of white pixels */ |
|
L_INT32 iBlackCount; |
/* number of black pixels */ |
|
/* pointer to additional parameters */ |
Handles each inverted text segment found by L_InvertedTextBitmap. This function is available in the Document/Medical Toolkits.
|
Parameter |
Description |
|
hRgn |
Windows region representing the inverted text to be removed. It is the programmers responsibility to delete this region (using DeleteObject()) when it is no longer needed. |
|
pBoundingRect |
Pointer to a RECT structure that contains the bounding rectangle of the inverted text region being processed. |
|
iWhiteCount |
Total number of white pixels in the inverted text region being processed. |
|
iBlackCount |
Total number of black pixels in the inverted text region being processed. |
|
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_InvertedTextBitmap.) |
|
|
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 |
Invert the text. |
|
SUCCESS_NOREMOVE |
Do not invert the text. |
|
Otherwise |
An error occurred. Refer to Return Codes. |
Comments
The callback is called once for each area of inverted text that is detected. Return SUCCESS_REMOVE to have the area modified. Return SUCCESS_NOREMOVE to leave the area unchanged. Pass any other value to abort. This value will be the return value of the L_InvertedTextBitmap() . If flags INVERTEDTEXT_IMAGE_UNCHANGED and INVERTEDTEXT _SINGLE_REGION are being used, then the return value of the callback 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. |
See Also
|
Functions: |
|
|
Topics: |
Example
For an example, refer to L_InvertedTextBitmap.