ShowHolePunchRemoveDlg method (LEADDlgImgDoc Control)

C++ Builder example

Delphi 4.0 example

 

Builder Syntax

int ShowHolePunchRemoveDlg(TWinControl* AOwnerCtrl);

Delphi Syntax

Function ShowHolePunchRemoveDlg (AOwnerCtrl: TWinControl ): L_INT;

Overview

Refer to Using Imaging Common Dialogs.

Remarks

(Document/Medical only) Displays the Hole Punch Remove dialog box and gets the options for the HolePunchRemove method.

The layout and action of the dialog depends on the flags set in the DlgFlags property. Possible options are:

Value

Meaning

DLG_HOLEPUNCHREMOVE_AUTOPROCESS

[$00000001] Process the image on OK. The Common Dialog LEADImage property must be assigned a Main Control containing a valid 1-bit bitmap before calling this method.

DLG_HOLEPUNCHREMOVE_SHOW_CONTEXTHELP

[$00000002] Dialog should contain a context sensitive help icon.

DLG_HOLEPUNCHREMOVE_SHOW_PREVIEW

[$00000004] Show a preview of the image in the dialog. The Common Dialog LEADImage property must be assigned a Main Control containing a valid 1-bit bitmap before calling this method.

DLG_HOLEPUNCHREMOVE_SHOW_TOOL_ZOOMLEVEL

[$00000008] Show the "Zoom to fit" and "Zoom Normal" toolbar buttons. The DLG_HOLEPUNCHREMOVE_SHOW_PREVIEW flag must be set in order to show these buttons.

If you include DLG_HOLEPUNCHREMOVE_AUTOPROCESS or DLG_HOLEPUNCHREMOVE_SHOW_PREVIEW in the DlgFlags property, the Common Dialog LEADImage property must be assigned a Main Control containing a valid 1-bit bitmap before calling this method.

The HolePunchRemove method only works with 1-bit images. If you provide a Main Control in the LEADImage property, it must be contain a valid 1-bit bitmap.

The properties associated with this dialog box are:

ProcessFlags property.

MinHoleCount property.

MaxHoleCount property.

MinHoleWidth property.

MinHoleHeight property.

MaxHoleWidth property.

MaxHoleHeight property.

Location property.

DocCleanBitmap property.

DocCleanRgn property.

WhiteAreaColor property.

BlackAreaColor Property.

To include a Help button in the dialog, set the ShowHelpButton property to TRUE.

The Hole Punch Remove dialog can be seen below:

image\HolePunchRemove.gif

See Also

Elements:

HolePunchRemove method, ProcessFlags property, MinHoleCount property, MaxHoleCount property, MinHoleWidth property, MinHoleHeight property, MaxHoleWidth property, MaxHoleHeight property, Location property, DocCleanBitmap property, WhiteAreaColor property, BlackAreaColor property, ShowHelpButton property, DlgFlags property, ZoomToFit Property, EnableMethodErrors property.

Topics:

Imaging Common Dialogs: Properties, Methods, and Events