HolePunchRemoveEvent event (Main Control)

Visual Basic Example
Visual C++ 4.0 example

Syntax void HolePunchRemoveEvent (OLE_HANDLE hRgn, float fBoundingRectLeft, float fBoundingRectTop, float fBoundingRectWidth, float fBoundingRectHeight, long iHoleIndex, long iHoleTotalCount, long iWhiteCount, long iBlackCount);

Overview:  Refer to Cleaning - up 1-Bit Images

Remarks

(Document/Medical) This event is triggered once for each occurring hole in the hole-punch configuration. For example, if there are three holes, the event gets triggered three times. Set the DocCleanSuccess property to SUCCESS_REMOVE to have a particular hole removed. Set the DocCleanSuccess property to SUCCESS_NOREMOVE to leave the hole unchanged. Set the DocCleanSuccess property to 0 to abort. If the uFlags parameter of the HolePunchRemove method is set to HOLEPUNCH_IMAGE_UNCHANGED and HOLEPUNCH_SINGLE_REGION, then the value of the DocCleanSuccess property affects only the internal single region that contains all the changes.

Note: hRgn is only valid during this event. To use the hRgn after the event has terminated, make a copy of it using the SetBitmapRgnHandle method.

See Also

Elements:  HolePunchRemove method

Topics:  Raster Images: Cleaning - up 1-Bit Images