FileBrowser

Object Hierarchy

Introduced

2.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



Autodesk Softimage v7.5