<?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="pcontrol" module="max" category="Patching">
	<digest>
		Open and close subwindows
	</digest>
	<description>
		Serves as a remote control for patcher/subpatcher windows and functions.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			Patching
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				Control Message to Send to Patcher Window
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Connect to Inlet of Patcher to be Controlled
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--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="close">
			<arglist>
				<arg name="patcher" optional="0" type="list" />
			</arglist>
			<digest>
				Close the patcher window
			</digest>
			<description>
				Closes the patcher window of any subpatches or patcher objects connected to the <o>pcontrol</o> object's outlet.
			</description>
		</method>
		<method name="help">
			<arglist>
				<arg name="filename" optional="0" type="symbol" />
			</arglist>
			<digest>
				Open a help file
			</digest>
			<description>
				The word <m>help</m>, followed by a symbol, opens a help file in Max's max-help folder with the name of the symbol followed by <m>.help</m>.
			</description>
		</method>
		<method name="load">
			<arglist>
				<arg name="filename" optional="0" type="list" />
			</arglist>
			<digest>
				Load a patcher file
			</digest>
			<description>
				The word <m>load</m>, followed by the name of a patcher file, opens that file if it can be found in Max's search path. The file name may optionally be followed by up to nine numbers and/or symbols, which will be substituted for the appropriate changeable <m>#</m> arguments (<m>#1</m> to <m>#9</m>) in the patch being opened.
			</description>
		</method>
		<method name="loadunique">
			<arglist>
				<arg name="patcher" optional="0" type="list" />
			</arglist>
			<digest>
				Load a single patcher instance
			</digest>
			<description>
				The word <m>loadunique</m>, followed by the name of a patcher file, opens a single instance that file if it can be found in Max's search path. If the file has already been loaded, the previously loaded copy will be activated (i.e. only a single copy of the file may be opened). As with the <m>load</m> message, the file name may optionally be followed by up to nine numbers and/or symbols, which will be substituted for the appropriate changeable <m>#</m> arguments (<m>#1</m> to <m>#9</m>) in the patch being opened.
			</description>
		</method>
		<method name="open">
			<arglist>
				<arg name="patcher" optional="0" type="list" />
			</arglist>
			<digest>
				Open a patcher window
			</digest>
			<description>
				Opens the patcher window of any subpatches or patcher objects connected to the <o>pcontrol</o> object's outlet.
			</description>
		</method>
		<method name="shroud">
			<arglist>
				<arg name="filename" optional="0" type="list" />
			</arglist>
			<digest>
				Open a patcher without opening the window
			</digest>
			<description>
				The word <m>shroud</m>, followed by the name of a patcher file, opens that file but does not show its window. (Use this message with care, since having patchers open but invisible can potentially lead to some disconcerting results.)
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="pcontrol.png" caption="Show/hide a subpatch window, or enable/disable its MIDI objects" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="bpatcher" />
		<seealso name="inlet" />
		<seealso name="patcher" />
		<seealso name="thispatcher" />
	</seealsolist>
	<misc name="Output">
		<entry name="Patcher-Control">
			<description>
				Any subpatches or patcher objects connected to the <o>pcontrol</o> object's outlet can have their patcher window opened or closed, or MIDI enabled/disabled, when the appropriate message is received in the inlet of <o>pcontrol</o>.
			</description>
		</entry>
	</misc>
</c74object>
