Displays the Win32 common file open dialog and allows you to select a file on disk.

Prototype

string BrowseFileOpen( int32 p_eFileType, int32 p_eMultipleFiles, string p_sCustomFilter, string p_sInitialFile, string p_sTitle, StrList p_oFiles )

Parameters

Parameter Type	Parameter Name	Documentation
int32	p_eFileType	The type of file to open. Prefer passing in the enumeration value Enum.OSFD_CustomFilter() for this parameter, and also pass in a custom filter string. This value refers to the OSFileDialog_Filters enumeration. Please see TYPE_SERVICE_ENUMERATION_UTIL.SSL in the application scripts folder for more information.
int32	p_eMultipleFiles	If true, allows the user to select multiple files from the dialog. Otherwise only allows the user to select a single file. This refers to the OSFileDialog_Mode enumeration. Please see TYPE_SERVICE_ENUMERATION_UTIL.SSL in the application scripts folder for more information.
string	p_sCustomFilter	A string containing the custom filter. For example: 'All Imagery Files (.bmp; .png; .tga; .tif; .exr; .image)\|.bmp; .png; .tga; .tif; .exr; .image\|All Files (.)\|.\|\|;'. This must conform to the Windows file filter format. Please see APP_SERVICE_MAIN_UTIL.SSL for examples on constructing properly formatted filter strings.
string	p_sInitialFile	An absolute path (C:\\MyFolder\\AnotherFolder\\) to the initial location to look for files to choose.
string	p_sTitle	The title text for the dialog.
<StrList>	p_oFiles	A pointer to the <StrList> object that will store the file paths selected by the user. This will contain a list of absolute paths chosen by the user when they dismiss the dialog.