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

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

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 : All Graphics formats

2 : TIFF Bitmap (TIF;TIFF;FAX)

3 : GIF (GIF) - if enabled

4 : JPEG Bitmap (JPG;JPEG;JPE)

5 : PaintBrush (PCX)

6 : Windows Bitmap (BMP;DIB;RLE)

7 : Windows Icon (ICO)

8 : Windows Cursor (CUR)

9 : Portable Network Graphics (PNG)

10 : Windows Metafile (WMF)

11 : Enhanced Windows Metafile (EMF)

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

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

14 : Wireless bitmap (WBMP)

15 : Jpeg2000 (JP2)

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

17 : Video for Windows (AVI)

multiSelect
Boolean
If MultiSelect is True then it is possible to select multiple files. The returned string contains a list of filename separated by '|' character ('one.jpg|two.jpg').

Return Value

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

Remarks

This sample shows the open dialog then load the selected file

CopyC#
ImageList.LoadImages( ImageList.ExecuteOpenDialog("","",true,1) );

See Also