module FileDialogs
This module defines functions that present dialog boxes for requesting new and existing files and directories according
to platform conventions.
Parameters
The following parameters are used by these functions:
- prompt
- A prompt string to be displayed. It is up to the platform exactly
where and how the prompt is shown, and it may not be shown at all in
some cases. If omitted, a suitable default is used depending on the
type of request.
- default_dir
- A FileRef or DirRef
specifying the initial directory to be browsed. If omitted, a
platform-dependent default is used (usually the last directory visited
in the application by a file dialog).
- default_name
- For functions that request a new object name, the initial value
entered into the name area of the dialog. If omitted, the name area is
initially empty.
- file_type, file_types
- A FileType or list of FileTypes specifying acceptable file types.
Functions
- request_old_file(prompt = None, default_dir = None, file_types = None)
- Prompts the user to select an existing file. If any file_types are supplied, the user is only allowed to select a file matching one of the specified types.
- Returns a FileRef, or None if the user cancelled.
- request_old_files(prompt = None, default_dir = None, file_types = None)
- Prompts the user to select a set of existing files. If any file_types are supplied, the user is only allowed to select files matching one of the specified types.
- Returns a list of FileRefs, or None if the user cancelled.
- request_new_file(prompt = None, default_dir = None, default_name = None, file_type = None)
- Prompts the user to supply a name and location for a new file. If file_type
is specified, it should represent the type if file which is to be
created; some platforms use this to restrict the list of existing files
displayed, and to determine the suffix of the returned filename.
- Returns a FileRef, or None if the user cancelled.
- request_old_directory(prompt = None, default_dir = None)
Prompts the user to select an existing directory.
- Returns a FileRef, or None if the user cancelled.
- request_old_directories(prompt = None, default_dir = None)
Prompts the user to select a set of existing directories.
- Returns a list of FileRefs, or None if the user cancelled.
- request_new_directory(prompt = None, default_dir = None, default_name = None)
- Prompts the user to supply a name and location for a new directory.
- Returns a FileRef, or None if the user cancelled.
---