Player
Documentation
Frontier
User's Guide
Chapter 5, Verbs
One Verb Per Page
Player.setDialogFolder
Syntax
Player.setDialogFolder(path)
Parameters
path is the path name to a folder.
Action
Sets the folder that the next standard file dialog will display. (Does not support the new "Navigation Services" dialogs.)
Returns
True.
Examples
Player.setDialogFolder("Macintosh HD:Cool Stuff:Benchmarks")
Player.chooseMenu("File", "Save As")
Errors
The folder does not exist.
Notes
- This verb works only with "classic" standard file dialogs not with the new "Navigation Services" dialogs.
- Call this verb before performing an action that displays a standard file dialog; it sets the folder that the dialog will show when displayed.
- The verb can also be called while the dialog is open, though that's less efficient.
- The verb requires a string or alias, it will not accept a Finder reference.
- Instead of using Player (and this new verb) to open a file by controlling the Open file dialog, you can usually tell the application or the Finder to open the file. This verb is still useful for the Save dialog or Import dialogs.
- If you do need to point to a file, just use the type verb with the name of the file (after the dialog is open):
with Player
setDialogFolder("Macintosh HD:Here")
chooseMenu("File", "Import")
typeText("results doc")
clickButton("Import")- This verb replaces locateFile and locateFolder which are now obsolete.
Keywords
dialogs[1] version1.1
setForcedYield
Copyright 1993-99, PreFab Software, Inc. All Rights Reserved.
This site built and maintained using Stage Three, a set of custom Frontier scripts.