ShowGetShapeDlg method (LEADDlgEffect Control)

C++ Builder example

Delphi 4.0 example

 

Builder Syntax

int ShowGetShapeDlg(TWinControl* AOwnerCtrl);

Delphi Syntax

Function ShowGetShapeDlg (AOwnerCtrl: TWinControl ): L_INT;

Overview

Refer to Using Imaging Common Dialogs.

Remarks

Displays the Get Shape dialog box, and gets the options for Shape properties and the DrawShape method.

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

Value

Meaning

DLG_SHAPE_SHOW_CONTEXTHELP

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

DLG_SHAPE_AUTOPREVIEW

[$00000002] Auto preview when options change

DLG_SHAPE_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 bitmap before calling this method.

DLG_SHAPE_BACKSTYLE

[$00000008] Back style is an option

DLG_SHAPE_FILLSTYLE

[$00000010] Fill style is an option

DLG_SHAPE_FORE_BACK_COLOR

[$00000020] Fore and back colors are options

DLG_SHAPE_BORDERSTYLE

[$00000040] Border style is an option

DLG_SHAPE_BORDERWIDTH

[$00000080] Border width is an option

DLG_SHAPE_BORDERCOLOR

[$00000100] Border color is an option

DLG_SHAPE_INNERSTYLE

[$00000200] inner band style is an option

DLG_SHAPE_INNERWIDTH

[$00000400] inner band width is an option

DLG_SHAPE_INNER_HILITE_SHADOW

[$00000800] inner band colors are options

DLG_SHAPE_OUTERSTYLE

[$00001000] Outer band style is an option

DLG_SHAPE_OUTERWIDTH

[$00002000] Outer band width is an option

DLG_SHAPE_OUTER_HILITE_SHADOW

[$00004000] Outer band colors are options

DLG_SHAPE_SHADOWCOLOR

[$00008000] Shadow color is an option

DLG_SHAPE_SHADOW_X_Y

[$00010000] Shadow x and y are options

DLG_SHAPE_BROWSEIMAGE

[$00020000] Browse image button is an option

DLG_SHAPE_NO_TREEVIEW

[$00040000] DO NOT use the TreeView

DLG_SHAPE_CLASS_SQUARE

[$00080000] Squares are options

DLG_SHAPE_CLASS_RECTANGLE

[$00100000] Rectangles are options

DLG_SHAPE_CLASS_PARALLELOGRAM

[$00200000] Parallelograms are options

DLG_SHAPE_CLASS_TRAPEZOID

[$00400000] Trapezoids are options

DLG_SHAPE_CLASS_TRIANGLE

[$00800000] Triangles are options

DLG_SHAPE_CLASS_OTHER

[$01000000] Other polygons are options

DLG_SHAPE_CLASS_CIRCLE

[$02000000] Circles are options

DLG_SHAPE_CLASS_ELLIPSE

[$04000000] Ellipses are options

DLG_SHAPE_CLASS_STAR

[$08000000] Stars are options

DLG_SHAPE_CLASS_CROSS

[$10000000] Crosses are options

DLG_SHAPE_CLASS_ARROW

[$20000000] Arrows are options

These values may be combined by ORing them.

If you include DLG_SHAPE_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:

Shape property

ShapeBackgroundStyle property

ShapeFillStyle property

ShapeBorderColor property

ShapeBorderStyle property

ShapeBorderThickness property

ShapeInnerBandStyle property

ShapeInnerBandThickness property

ShapeInnerBandHiliteColor property

ShapeInnerBandShadowColor property

ShapeOuterBandStyle property

ShapeOuterBandThickness property

ShapeOuterBandHiliteColor property

ShapeOuterBandShadowColor property

ShadowXDepth property

ShadowYDepth property

ShadowColor property

ShapeBackgroundBitmap property

ForeColor property property

BackColor property property

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

The Get Shape dialog can be seen below:

image\GetShape.gif

See Also

Elements:

DrawShape method, ShapeLeft property, ShapeTop property, ShapeWidth property, ShapeHeight property, ShapeBackgroundStyle property, BackgroundImageHeight property, BackgroundImageLeft property, BackgroundImageTop property, BackgroundImageWidth property, ShapeBorderColor property, ShapeBorderStyle property, ShapeBorderThickness property, ShapeInnerBandHiliteColor property, ShapeInnerBandShadowColor property, ShapeInnerBandStyle property, ShapeInnerBandThickness property, ShapeOuterBandHiliteColor property, ShapeOuterBandShadowColor property, ShapeOuterBandStyle property, ShapeOuterBandThickness property, DlgFlags property, ShowHelpButton property.

Topics:

Imaging Common Dialogs: Properties, Methods, and Events