## FileBrowser

Object Hierarchy

### Introduced

v2.0

### Description

A simple file browser that can be used in scripts to let users specify the full path name of a single file that needs to be either saved or opened. You can access the FileBrowser through the XSIUIToolkit object. This is a concrete (leaf) object.

### Methods

ShowOpen | ShowSave |  |

### Properties

DialogTitle | FileBaseName | FileExtension | FileName
FilePath | FilePathName | Filter | InitialDirectory

### Examples

#### 1. VBScript Example

    'VBScript example

    dim oFileBrowser

    set oFileBrowser = XSIUIToolkit.FileBrowser

    oFileBrowser.DialogTitle = "Select a file"	' set the title of the file browser

    oFileBrowser.InitialDirectory = "c:\"		' set the initial directory

    oFileBrowser.FileBaseName = "foo"			' set the default file name

    oFileBrowser.Filter = "Text (*.txt)|*.txt|All Files (*.*)|*.*||"	' set the filters

    oFileBrowser.ShowOpen					' show an open file dialog

    logmessage VB_LF

    ' if the user selected a file

    If oFileBrowser.FilePathName <> "" Then

    ' display info on the selected file

    	logmessage "Details on the file that was selected:"

    	logmessage "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~"

    	logmessage "File path name : " & oFileBrowser.FilePathName

    	logmessage "File Name      : " & oFileBrowser.FileName

    	logmessage "File base name : " & oFileBrowser.FileBaseName

    	logmessage "File extension : " & oFileBrowser.FileExtension

    	logmessage "Path           : " & oFileBrowser.FilePath

    ' the user did not select a file

    Else

    logmessage "User pressed cancel"

    End If

#### 2. JScript Example

    // JScript example of FileBrowser object

    var initialDir ;

    if ( Application.Platform == "Win32" )

    {

    	initialDir = "c:\\temp\\" ;

    }

    else

    {

    	initialDir = "/var/tmp" ;

    }

    var oUIToolkit = new ActiveXObject("XSI.UIToolKit") ;

    var oFileBrowser = oUIToolkit.FileBrowser ;

    oFileBrowser.DialogTitle = "Select a file" ;

    oFileBrowser.InitialDirectory = initialDir ;

    oFileBrowser.Filter = "All Files (*.*)|*.*||" ;

    oFileBrowser.ShowOpen() ;

    if ( oFileBrowser.FilePathName != "" )

    {

    	//display info on the selected file

    	logmessage( "\nDetails on the file that was selected:" );

    	logmessage( "~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~");

    	logmessage( "File path name : " + oFileBrowser.FilePathName);

    	logmessage( "File Name      : " + oFileBrowser.FileName);

    	logmessage( "File base name : " + oFileBrowser.FileBaseName);

    	logmessage( "File extension : " + oFileBrowser.FileExtension);

    	logmessage( "Path           : " + oFileBrowser.FilePath);

    }

    else

    {

    	logmessage( "User pressed cancel" ) ;

    }

### See Also

XSIUIToolkit