ShowAddFrameDlg method (LEADDlgImage Control)

C++ Builder example

Delphi 4.0 example

 

Builder Syntax

int ShowAddFrameDlg(TWinControl* AOwnerCtrl);

Delphi Syntax

Function ShowAddFrameDlg (AOwnerCtrl: TWinControl): L_INT;

Overview

Refer to Using Imaging Common Dialogs.

Remarks

(Raster Pro and above toolkits only) Displays the Add Frame dialog box and get the options of AddFrame method.

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

Value

Meaning

DLG_ADDFRAME_AUTOPROCESS

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

DLG_ADDFRAME_SHOW_CONTEXTHELP

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

DLG_ADDFRAME_SHOW_PREVIEW

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

DLG_ADDFRAME_SHOW_TOOL_ZOOMLEVEL

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

DLG_ADDFRAME_SHOW_TOOL_COLORPICKER

[$00000010] Show the Color button.

DLG_ADDFRAME_SHOW_APPLY

[$00000100] Show the Apply button in the dialog. The dialog will not apply any effect unless the user presses the Apply button.

If you include DLG_ADDFRAME_AUTOPROCESS or DLG_ADDFRAME_SHOW_PREVIEW in the DlgFlags property, the LEADImage property must be assigned a Main Control containing a valid bitmap before calling this method.

The properties associated with this dialog are:

BitmapIndex property.

Location property.

UseMask property.

KeepFrameState property.

MaskColor property.

SmoothEdge property.

Quality property.

ItemsCount property.

ItemDescription property.

ItemFileName property.

ItemBitmap property.

SelectedBitmap property.

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

The Histogram dialog can be seen below:

image\Histogram.gif

See Also

Elements:

AddFrame method, BitmapIndex property, Location property, UseMask property, KeepFrameState property, MaskColor property, SmoothEdge property, Quality property, ItemsCount property, ItemDescription property, ItemFileName property, ItemBitmap property, SelectedBitmap property, ShowHelpButton property, DlgFlags property, ZoomToFit Property, EnableMethodErrors property.

Topics:

Imaging Common Dialogs: Properties, Methods, and Events