ShowDotRemoveDlg method (LEADDlgImgDoc Control)

C++ Builder example

Delphi 4.0 example

 

Builder Syntax

int ShowDotRemoveDlg(TWinControl* AOwnerCtrl);

Delphi Syntax

Function ShowDotRemoveDlg (AOwnerCtrl: TWinControl): L_INT;

Overview

Refer to Using Imaging Common Dialogs.

Remarks

(Document/Medical only) Displays the Dot Remove dialog box, and gets the options for the DotRemove method.

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

Value

Meaning

DLG_DOTREMOVE_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_DOTREMOVE_SHOW_CONTEXTHELP

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

DLG_DOTREMOVE_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_DOTREMOVE_SHOW_TOOL_ZOOMLEVEL

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

If you include DLG_DOTREMOVE_AUTOPROCESS or DLG_DOTREMOVE_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 DotRemove 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

MinDotWidth property

MinDotHeight property

MaxDotWidth property

MaxDotHeight property

DocCleanBitmap property

DocCleanRgn property

WhiteAreaColor property

BlackAreaColor Property

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

The Dot Remove dialog can be seen below:

image\DotRemove.gif

See Also

Elements:

DotRemove method, ProcessFlags property, MinDotWidth property, MinDotHeight property, MaxDotWidth property, MaxDotHeight property, DocCleanBitmap property, WhiteAreaColor property, BlackAreaColor property, ShowHelpButton property, DlgFlags property, ZoomToFit Property, EnableMethodErrors property.

Topics:

Imaging Common Dialogs: Properties, Methods, and Events