Handles each hole punch found by L_HolePunchRemoveBitmap.
Windows region representing one of the holes of the hole punch pattern. It is the programmers responsibility to delete this region (using DeleteObject())when it is no longer needed.
Pointer to a RECT structure that contains the bounding rectangle of one of the holes in a hole punch pattern.
Index of the hole within a hole punch pattern. The holes are numbered from 1 to n, where n is the total number of holes in the hole punch pattern.
The total number of holes that make up the hole punch pattern. This value will not change for a particular call to L_HolePunchRemoveBitmap().
Total number of white pixels in one of the holes of a hole punch pattern.
Total number of black pixels in one of the holes of a hole punch pattern.
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_HolePunchRemoveBitmap).
Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.
|SUCCESS_REMOVE||Remove the hole.|
|SUCCESS_NOREMOVE||Do not remove the hole.|
|Otherwise||An error occurred. Refer to Return Codes.|
The callback is called once for each occurring hole in the hole punch configuration. For example, if there are three holes, the callback gets called three times. Return SUCCESS_REMOVE to have a particular hole removed. Return SUCCESS_NOREMOVE to leave the hole unchanged. Pass any other value to abort. This value will be the return value of the L_HolePunchRemoveBitmap() . If HOLEPUNCH_IMAGE_UNCHANGED and HOLEPUNCH_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
For an example, refer to L_HolePunchRemoveBitmap.
Medical Web Viewer .NET
.NET, Java, Android, and iOS/macOS Assemblies
C API/C++ Class Libraries