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: 10.1.0.0

Syntax

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

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)

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