A newer version of Max is available. Click here to access the latest version of the documentation

opendialog Reference

Open a dialog to ask for a file or folder

opendialog

Description

Use the opendialog object to select a file of a specific type or folder from a standard dialog window. To choose a folder, use the "fold" type. opendialog reports the entire pathname of the file or folder chosen, which can be passed to any Max object after the word read or load.

Examples

Look for folders or a certain kind of file

Arguments

folder [symbol]

Optional

Sets opendialog to choose folders only

soundfile [symbol]

Optional

Use this argument to list audio files (AIFF, NeXT/Sun, and WAV, along with some generic data file types). Jitter Appendix A lists all the files that can be opened.

file-types [symbol]

Optional

One or more symbols set the list of file types that determine which files are listed by the opendialog object.

Attributes

Common Box Attributes

Messages

bang

Opens a standard Open Document dialog window for choosing a file or folder.

anything

Arguments

filetype [list]
One or more symbols are interpreted as one or more type codes used to determine which files are listed by the opendialog object. Example type codes for files are TEXT for text files, maxb for Max binary format patcher files, and AIFF for AIFF format audio files. types with no arguments makes the object accept all file types, which is the default setting.

set

Arguments

filetype [list]
The word set, followed by one or more four-letter filetype codes sets the opendialog object to search for the specified file type(s) without opening a dialog window. Example type codes for files are TEXT for text files, maxb for Max binary format patcher files, and AIFF for AIFF format audio files. set with no arguments makes the object accept all file types, which is the default setting.

sound

Sets opendialog to list audio files (AIFF, NeXT/Sun, and WAV, along with some generic data file types) and opens a standard dialog window. Jitter Appendix A lists all the files that can be opened.

types

Arguments

filetype [list]
The word types, followed by one or more four-letter filetype codes sets the opendialog object to search for the specified file type(s) and opens a standard dialog window. Example type codes for files are TEXT for text files, maxb for Max binary format patcher files, and AIFF for AIFF format audio files. types with no arguments makes the object accept all file types, which is the default setting.

Output

bang

If the dialog box is cancelled by the user, a bang message is sent out the right outlet.

symbol

Out left outlet: The absolute pathname of the file chosen by the user as a symbol. The output pathnames contain slash separators.

Absolute pathnames look like this:

"C:/Max Folder/extras/mystuff/mypatch.pat"

The conformpath object can be used to convert paths of one pathtype and/or pathstyle to another.

See Also

Name Description
Search Paths Search Paths
conformpath
dialog
dropfile
date
filedate
filein
filepath
folder
savedialog
strippath