file.getFileDialog

Syntax file.getFileDialog (prompt, addr, type)
Params prompt is a string to be displayed in the dialog.

addr is the address of the Frontier object where the path to the file will be stored if the user selects a file.

type is a string4 identifying the type of the file on Mac OS; on Windows it is a string containing the file extension.
Action Prompts the user to select a file, displaying available files of the indicated type.
Returns True if the user clicked on OK, false if the user cancels the action. Also places the user's response into the Object Database table at location addr unless the user cancels the dialog, in which case addr is left unchanged.
Examples file.getFileDialog ("Pick a file, any file", @x, 0); return (x)

   » "C:\\Program Files\\Frontier\\Frontier.exe"

file.getFileDialog ("Pick a file, any file", @x, ".txt"); return (x)

   » "C:\\Program Files\\Frontier\\blah.txt"


file.getFileDialog ("Select an application", @scratchpad.x, 'APPL');
return (scratchpad.x)

   » System:Frontier 1.0:UserLand Frontier

Places the string in scratchpad.x and displays it as well.

file.getFileDialog ("Select a file", @x, 0);
return (x)

   » System:System Folder:Finder

Places the string in the local variable x and displays it as well.

if file.getFileDialog ("TeachText file", @x, {'TEXT', 'ttro'}) {return (file.type (x))}

   » 'ttro'

You can also pass a list of string4 values to display more than one type (up to ten).

Notes Only files of the indicated type are displayed in the dialog. To display more than one type pass a list of values. To display all files set type to 0.

The standard file dialog displayed by the Frontier verb file.getFileDialog automatically follows aliases for the user. In other words, when the user selects an alias file in that dialog, the path to the original file is actually returned and

the original file is opened.
See Also file.getFolderDialog

file.putFileDialog

file.getDiskDialog

Discuss