Copyright © 2011-2018 MultiMedia Soft

CommonDialogShowOpen method

Previous pageReturn to chapter overviewNext page

Remarks

 

Displays the standard dialog box used to select a file for opening. This method allows accessing filenames containing Unicode characters from development environments whose common dialog components don't manage Unicode natively like the "Microsoft Common Dialog Control" (ComDlg32.ocx) used by Visual Basic 6.

 

After choosing an input file, you can access more detailed information about it through the CommonDialogGetInfoFromLastOpen method.

 

 

Syntax

 

[Visual Basic]

Public Function CommonDialogShowOpen (

strDialogTitle as string,

strInitialDirectory as string,

strFilter as string,

nFilterIndex as Int32

) as String


 

[C#]

public string CommonDialogShowOpen (

string strDialogTitle,

string strInitialDirectory,

string strFilter,

ref Int32 nFilterIndex

);


 

[C++]

public: string CommonDialogShowOpen (

string strDialogTitle,

string strInitialDirectory,

string strFilter,

Int32 __gc *nFilterIndex

);


 

 

Parameter

Description

 

 

strDialogTitle

String representing the caption text of the dialog box.

strInitialDirectory

String representing the path of the directory where the browsing starts from.

strFilter

String representing the filter that let users limit which filenames appear for selection. For example:

"MP3 Files (*.mp3)|*.Mp3|WMA Files (*.wma)|*.wma|All Files (*.*)|*.*"

nFilterIndex

Reference that, on return from the method call, will contain the 1-based index of the filter selected by the user.

 

 

Return value

 

Value

Meaning

 

 

Empty string

The user pressed the Cancel button or didn't selected any file.

Valid string

The absolute pathname of the chosen file.