Displays a standard windows folder selection dialog box.
Usage:
dlgFolder (object me, string title, string defaultPath)
Parameters:
title (string) - string that is displayed above the tree view control in the dialog box. This string can be used to specify instructions to the user.
defaultPath (string) - string specifying the path to an existing folder. Optional Parameter. When parameter not specified, the default path is 'My Documents'
Returns:
(string) - if the user selects a valid file, the file path is returned
(integer) - negative integer is returned if the user cancels the dialog box
Example:
-- asks the user to select a folder to install the bitmap to
xtRose = xtra("Rosetta").new( )
strPath = xtRose.dlgFolder( "Please select folder to install to" )
If ( STRINGP(strPath) ) Then
xtRose.sysFileCopy( "c:\windows\winnt256.bmp", strPath&"test.bmp", 2 )
End If
Notes:
Optional 2nd parameter defaultPath was added in version 1.0.7.