Displays a modal Windows dialog box for selecting graphics files, used for saving.

This dialog includes a rectangular preview region where all IEvolution supported file formats all displayed.

If the file is a animated GIF, AVI film or a multi page TIFF, all image will be showed in sequence: the "Play" button will be activated to animated the sequence.

The dialog displays image informations as dimensions, colors, dpi, file type, compression and file-memory sizes.

Namespace: HiComponents.IEvolution
Assembly: IEvolution2 (in IEvolution2.dll) Version: 14.0.0.0

Syntax

         
 C#  Visual Basic  Visual C++ 
public string ExecuteSaveDialog(
	string initialDir,
	string initialFileName,
	bool alwaysAnimate,
	int filterIndex,
	bool modernDialog
)
Public Function ExecuteSaveDialog ( _
	initialDir As String, _
	initialFileName As String, _
	alwaysAnimate As Boolean, _
	filterIndex As Integer, _
	modernDialog As Boolean _
) As String
public:
String^ ExecuteSaveDialog(
	String^ initialDir, 
	String^ initialFileName, 
	bool alwaysAnimate, 
	int filterIndex, 
	bool modernDialog
)

Parameters

initialDir
String
the starting directory
initialFileName
String
the default file name
alwaysAnimate
Boolean
specify if the avi, gif, or multi-riff should be animated
filterIndex
Int32
specifies what file format to select for default. Allowed values:

1 : TIFF Bitmap (TIF;TIFF;FAX)

2 : GIF (GIF) - if enabled

3 : JPEG Bitmap (JPG;JPEG;JPE)

4 : PaintBrush (PCX)

5 : Windows Bitmap (BMP;DIB;RLE)

6 : Windows Icon (ICO)

7 : Portable Network Graphics (PNG)

8 : Targa Bitmap (TGA;TARGA;VDA;ICB;VST;PIX)

9 : Portable Pixmap, GreyMap, BitMap (PXM;PPM;PGM;PBM)

10 : Wireless Bitmap (WBMP)

11 : Jpeg2000 (JP2)

12 : Jpeg2000 Code Stream (J2K;JPC;J2C)

13 : PostScript Level 2 (PS;EPS)

14 : Adobe PDF (PDF)

15 : Multipage PCX (DCX)

16 : Video for Windows (AVI)

modernDialog
Boolean
if enabled, a modern Windows dialog will be used rather than the internal IEvolution one

Return Value

returns the selected file name, or empty string if user press Cancel

Examples

This sample shows the save dialog then save the specified file

CopyC#
Image.SaveImage( Image.ExecuteSaveDialog("","",true,1) );

See Also