ShowGetEffectDlg method (LEADDlgEffect Control)

Builder Syntax	int ShowGetEffectDlg(Controls::TWinControl* AOwnerCtrl);
Delphi Syntax	Function ShowGetEffectDlg (AOwnerCtrl: TWinControl ): L_INT;
Overview	Refer to Using Imaging Common Dialogs.

Remarks

Displays the Get Effect dialog box, and gets the options for the Effect properties.

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

Value	Meaning
DLG_EFFECT_SHOW_CONTEXTHELP	[$00000001] Dialog should contain a context sensitive help icon.
DLG_EFFECT_SHOW_PREVIEW	[$00000002] Show a preview of the image in the dialog. The Common Dialog LEADImage property must be assigned a Main Control containing a valid bitmap before calling this method.
DLG_EFFECT_AUTOPREVIEW	[$00000004] Auto preview when options change
DLG_EFFECT_DELAY	[$00000008] Effect delay is an option.
DLG_EFFECT_GRAIN	[$00000010] Effect grain is an option.
DLG_EFFECT_PASSES	[$00000020] Effect passes is an option
DLG_EFFECT_TRANSPARENT	[$00000040] Transparency is an option
DLG_EFFECT_WAND	[$00000080] Wand is an option
DLG_EFFECT_NO_TREEVIEW	[$00000100] DO NOT use TreeView
DLG_EFFECT_CLASS_NONE	[$00000200] No effect is an option
DLG_EFFECT_CLASS_WIPE	[$00000400] Linear wipe is an option
DLG_EFFECT_CLASS_WIPERECT	[$00000800] Rectangular wipe is an option
DLG_EFFECT_CLASS_WIPECIRCLE	[$00001000] Circular wipe is an option
DLG_EFFECT_CLASS_PUSH	[$00002000] Push is an option
DLG_EFFECT_CLASS_SLIDE	[$00004000] Slide is an option
DLG_EFFECT_CLASS_ROLL	[$00008000] Roll is an option
DLG_EFFECT_CLASS_ROTATE	[$00010000] Rotate is an option
DLG_EFFECT_CLASS_ZOOM	[$00020000] Zoom is an option
DLG_EFFECT_CLASS_DRIP	[$00040000] Drip is an option
DLG_EFFECT_CLASS_BLIND	[$00080000] Blind is an option
DLG_EFFECT_CLASS_RANDOM	[$00100000] Random is an option
DLG_EFFECT_CLASS_CHECK	[$00200000] Check is an option
DLG_EFFECT_CLASS_BLOCKS	[$00400000] Blocks is an option
DLG_EFFECT_CLASS_CIRCLE	[$00800000] Circle is an option
DLG_EFFECT_CLASS_ELLIPSE	[$01000000] Ellipse is an option

These values may be combined by ORing them. If you include DLG_EFX_SHOW_PREVIEW in the DlgFlags property, the Common Dialog LEADImage property must be assigned a Main Control containing a valid bitmap before calling this method.

The following properties are associated specifically with this method:

Effect property

Grain property

Delay property

MaxPass property

Transparent property

TransparentColor property

WandThickness property

WandColor property

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

The Get Effect dialog can be seen below:

$image\GetEffect.gif$