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,
	string ExtendedFilters,
	string Title,
	string Filter
)
Public Function ExecuteSaveDialog ( _
	initialDir As String, _
	initialFileName As String, _
	alwaysAnimate As Boolean, _
	filterIndex As Integer, _
	ExtendedFilters As String, _
	Title As String, _
	Filter As String _
) As String
public:
String^ ExecuteSaveDialog(
	String^ initialDir, 
	String^ initialFileName, 
	bool alwaysAnimate, 
	int filterIndex, 
	String^ ExtendedFilters, 
	String^ Title, 
	String^ Filter
)

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)

ExtendedFilters
String
Specifies additional file formats (example: 'Fun Bitmap|*.fun;*.fan' ).
Title
String
Specifies the dialog title. Empty string means operating system default value.
Filter
String
Specifies file extensions to enable (i.e. 'JPEG Bitmap (JPG)|*.jpg|CompuServe Bitmap (GIF)|*.gif').

Return Value

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

See Also