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
)
Public Function ExecuteOpenDialog ( _
	initialDir As String, _
	initialFileName As String, _
	alwaysAnimate As Boolean, _
	filterIndex As Integer _
) As String
public:
String^ ExecuteOpenDialog(
	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 : Common graphics formats

2 : All files

3 : TIFF Bitmap (TIF;TIFF;FAX)

4 : GIF (GIF) - if enabled

5 : JPEG Bitmap (JPG;JPEG;JPE)

6 : PaintBrush (PCX)

7 : Windows Bitmap (BMP;DIB;RLE)

8 : Windows Icon (ICO)

9 : Windows Cursor (CUR)

10 : Portable Network Graphics (PNG)

11 : Windows Metafile (WMF)

12 : Enhanced Windows Metafile (EMF)

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

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

15 : Wireless bitmap (WBMP)

16 : Jpeg2000 (JP2)

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

18 : Multipage PCX (DCX)

19 : Camera RAW (RAW;CR2;CRW...)

20 : Video for Windows (AVI)

21 : Video Mpeg (MPEG)

22 : Windows Media Video (WMV)

Return Value

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

Examples

This sample shows the open dialog then load the selected file

CopyC#
Image.LoadImage( Image.ExecuteOpenDialog("","",true,1) );

See Also