<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>

<!--This is an automatically generated file. DO NOT EDIT THIS FILE DIRECTLY. Rather, use the _ref.xml files found in the 'edits' folder.-->
<c74object name="opendialog" module="max" category="Files">
	<digest>
		Open a dialog to ask for a file or folder
	</digest>
	<description>
		Use the <o>opendialog</o> object to select a file of a specific type or folder from a standard dialog window. To choose a folder, use the &quot;fold&quot; type. <o>opendialog</o> reports the entire pathname of the file or folder chosen, which can be passed to any Max object after the word <m>read</m> or <m>load</m>.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			Files
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				bang Shows Dialog, symbol(s) Set File Types
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
				bang Shows Dialog, symbol(s) Set File Types
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Complete Path of Chosen File
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				bang When User Cancels
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="folder" optional="1" type="symbol">
			<digest>
				Sets <o>opendialog</o> to choose folders only
			</digest>
			<description>
			</description>
		</objarg>
		<objarg name="soundfile" optional="1" type="symbol">
			<digest>
				Sets <o>opendialog</o> to choose audio files only
			</digest>
			<description>
				Use this argument to list audio files (AIFF, NeXT/Sun, and WAV, along with some generic data file types). The QuickTime appendix lists all the files that can be opened.
			</description>
		</objarg>
		<objarg name="file-types" optional="1" type="symbol">
			<digest>
				Set the list of file types
			</digest>
			<description>
				One or more symbols set the list of file types that determine which files are listed by the <o>opendialog</o> object.
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="bang">
			<arglist />
			<digest>
				Opens a dialog window
			</digest>
			<description>
				Opens a standard Open Document dialog window for choosing a file or folder.
			</description>
		</method>
		<method name="anything">
			<arglist>
				<arg name="filetype" optional="0" type="list" />
			</arglist>
			<digest>
				Sets file type list and opens a dialog window
			</digest>
			<description>
				One or more symbols are interpreted as one or more type codes used to determine which files are listed by the <o>opendialog</o> object. Example type codes for files are <m>TEXT</m> for text files, <m>maxb</m> for Max binary format patcher files, and <m>AIFF</m> for AIFF format audio files. <m>types</m> with no arguments makes the object accept all file types, which is the default setting.
			</description>
		</method>
		<method name="set">
			<arglist>
				<arg name="filetype" optional="0" type="list" />
			</arglist>
			<digest>
				Sets file type list without opening a dialog window
			</digest>
			<description>
				The word <m>set</m>, followed by one or more <link name="filetypes" module="core" type="vignette">four-letter filetype codes</link> sets the <o>opendialog</o> object to search for the specified file type(s) without opening a dialog window. Example type codes for files are <m>TEXT</m> for text files, <m>maxb</m> for Max binary format patcher files, and <m>AIFF</m> for AIFF format audio files. <m>set</m> with no arguments makes the object accept all file types, which is the default setting.
			</description>
		</method>
		<method name="types">
			<arglist>
				<arg name="filetype" optional="0" type="list" />
			</arglist>
			<digest>
				Sets file type list and opens a dialog window
			</digest>
			<description>
				The word <m>types</m>, followed by one or more <link name="filetypes" module="core" type="vignette">four-letter filetype codes</link> sets the <o>opendialog</o> object to search for the specified file type(s) and opens a standard dialog window. Example type codes for files are <m>TEXT</m> for text files, <m>maxb</m> for Max binary format patcher files, and <m>AIFF</m> for AIFF format audio files. <m>types</m> with no arguments makes the object accept all file types, which is the default setting.
			</description>
		</method>
		<method name="sound">
			<arglist />
			<digest>
				Sets <o>opendialog</o> to list audio files and opens a dialog
			</digest>
			<description>
				Sets <o>opendialog</o> to list audio files (AIFF, NeXT/Sun, and WAV, along with some generic data file types) and opens a standard dialog window. The QuickTime appendix lists all the files that can be opened.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="opendialog.png" caption="Look for folders or a certain kind of file" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="conformpath" />
		<seealso name="dialog" />
		<seealso name="dropfile" />
		<seealso name="date" />
		<seealso name="filedate" />
		<seealso name="filein" />
		<seealso name="filepath" />
		<seealso name="folder" />
		<seealso name="savedialog" />
		<seealso name="strippath" />
	</seealsolist>
	<misc name="Output">
		<entry name="symbol">
			<description>
				Out left outlet: The absolute pathname of the file chosen by the user as a symbol. The output pathnames contain slash separators.
				<br />
				<br />
				Absolute pathnames look like this:
				<br />
				<br />
				<m>&quot;C:/Max Folder/extras/mystuff/mypatch.pat&quot;</m> 				<br />
				<br />
				The <o>conformpath</o> object can be used to convert paths of one pathtype and/or pathstyle to another.
			</description>
		</entry>
		<entry name="bang">
			<description>
				If the dialog box is cancelled by the user, a <m>bang</m> message is sent out the right outlet.
			</description>
		</entry>
	</misc>
</c74object>
