<?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="dropfile" module="max" category="U/I">
	<digest>
		Drag and drop files
	</digest>
	<description>
		<o>dropfile</o> defines a region for dragging and dropping files into and then outputs the filepath and filetype upon file input.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			U/I
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				types Specifies Acceptable File Types
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Pathname of Dropped File
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
		<outlet id="1" type="OUTLET_TYPE">
			<digest>
				Type Code of Dropped File
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<palette category="Interface" action="dropfile" pic="dropfile.svg" />
	<!--ARGUMENTS-->
	<objarglist>
		<objarg id="0" name="OBJARG_NAME" type="OBJARG_TYPE" optional="0">
			<digest>
				TEXT_HERE
			</digest>
			<description>
				TEXT_HERE
			</description>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="(drag)">
			<digest>
				Drag and drop file
			</digest>
			<description>
				When a file icon is dragged from the Finder or Max File Browser onto a <o>dropfile</o> object in a locked patcher window, the object checks the file's type against those that it has been told to accept. If the file is of an acceptable type, the outline of the <o>dropfile</o> box is highlighted. If the mouse button is released while the cursor is inside the <o>dropfile</o> box, the <o>dropfile</o> object outputs the type and full pathname of the file out its outlets.
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<attributelist>
		<attribute name="border" get="1" set="1" type="float" size="1">
			<digest>
				Border size
			</digest>
			<description>
				Sets the size in pixels of the <o>dropfile</o> object's border.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="float" size="1" value="2." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Border Size" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="bordercolor" get="1" set="1" type="float" size="4">
			<digest>
				Border color
			</digest>
			<description>
				Sets the color of the <o>dropfile</o> border in RGBA format.
			</description>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Color" />
				<attribute name="defaultname" get="1" set="1" type="float" size="4" value="0.5 0.5 0.5 1." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Border Color" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="rgba" />
			</attributelist>
		</attribute>
		<attribute name="folderslash" get="1" set="1" type="int" size="1">
			<digest>
				Add a slash character (<b>/</b>)
			</digest>
			<description>
				Toggles adding a slash character (<b>/</b>) at the end of a folder name when output is triggered.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Behavior" />
				<attribute name="default" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Folder Trailing Slash" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="style" get="1" set="1" type="symbol" size="1" value="onoff" />
			</attributelist>
		</attribute>
		<attribute name="rounded" get="1" set="1" type="float" size="1">
			<digest>
				Rounded corner amount
			</digest>
			<description>
				Sets the amount in pixels by which to round the corners of the <o>dropfile</o> object.
			</description>
			<attributelist>
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Value" />
				<attribute name="default" get="1" set="1" type="float" size="1" value="8." />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Round-ness of Box Corners" />
				<attribute name="paint" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
		<attribute name="types" get="1" set="1" type="symbol" size="64">
			<digest>
				Sets file type list
			</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>dropfile</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>
			<attributelist>
				<attribute name="basic" get="1" set="1" type="int" size="1" value="1" />
				<attribute name="category" get="1" set="1" type="symbol" size="1" value="Value" />
				<attribute name="label" get="1" set="1" type="symbol" size="1" value="Matching Filetypes" />
				<attribute name="save" get="1" set="1" type="int" size="1" value="1" />
			</attributelist>
		</attribute>
	</attributelist>
	<!--EXAMPLE-->
	<examplelist>
		<example img="dropfile.png" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="absolutepath" />
		<seealso name="filepath" />
		<seealso name="folder" />
		<seealso name="opendialog" />
		<seealso name="relativepath" />
		<seealso name="strippath" />
	</seealsolist>
	<misc name="Output">
		<entry name="symbol">
			<description>
				Out left outlet: When an acceptable file icon has been dragged onto <o>dropfile</o> and the mouse released within its box, the absolute pathname of the file is sent out as a single 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.
				<br />
				<br />
				When aliases of folders are dragged onto <o>dropfile</o>, the aliases are resolved to create the output path.
				<br />
				<br />
				If you want to use the <o>dropfile</o> object to cause a file to be read by another object that accepts the <m>read</m> message with a filename argument, put a <link name="prepend" type="refpage">prepend read</link> object between <o>dropfile</o> and the object that will open a file, as shown in the example.
			</description>
		</entry>
		<entry name="any symbol">
			<description>
				Out right outlet: The <link name="filetypes" module="core" type="vignette">four-letter filetype code</link> of the acceptable file is sent out the right outlet.
			</description>
		</entry>
	</misc>
</c74object>
