<doc>
	<legacy_id>2234</legacy_id>
	<name>choose</name>
	<type>command</type>

	<syntax>
		<example>choose <i>toolName</i> tool</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary><glossary tag="select">Selects</glossary> a <function tag="tool">tool</function> or <glossary tag="paint tool">paint tool</glossary>.</summary>

	<examples>
<example>choose browse tool</example>
<example>choose tSavedTool tool</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Developing with LiveCode</category>
	</classification>

	<references>
		<function tag="tool">tool Function</function>
		<function tag="selectedImage">selectedImage Function</function>
		<command tag="reset cursors">reset cursors Command</command>
		<command tag="click">click Command</command>
		<command tag="drag">drag Command</command>
		<command tag="topLevel">topLevel Command</command>
		<command tag="rotate">rotate Command</command>
		<command tag="flip">flip Command</command>
		<property tag="tool">tool Property</property>
		<property tag="polySides">polySides Property</property>
		<property tag="lineSize">lineSize Property</property>
		<property tag="paintCompression">paintCompression Property</property>
		<property tag="penPattern">penPattern Property</property>
		<property tag="selected">selected Property</property>
		<property tag="spray">spray Property</property>
		<property tag="magnify">magnify Property</property>
		<property tag="brushPattern">brushPattern Property</property>
		<keyword tag="browse">browse Keyword</keyword>
		<keyword tag="brush">brush Keyword</keyword>
		<keyword tag="bucket">bucket Keyword</keyword>
		<keyword tag="button">button Keyword</keyword>
		<keyword tag="curve">curve Keyword</keyword>
		<keyword tag="dropper">dropper Keyword</keyword>
		<keyword tag="eraser">eraser Keyword</keyword>
		<keyword tag="field">field Keyword</keyword>
		<keyword tag="graphic">graphic Keyword</keyword>
		<message tag="newTool">newTool Message</message>
		<message tag="selectedObjectChanged">selectedObjectChanged Message</message>
	</references>

	<description>Use the <b>choose</b> <glossary tag="command">command</glossary> to <command tag="select">select</command> <glossary tag="object">objects</glossary>, create <glossary tag="object">objects</glossary>, or paint under scripted <keyword tag="control">control</keyword>.<p></p><p><b>Parameters:</b></p><p>The <i>toolName</i> is one of the basic <glossary tag="tool">tools</glossary> from the Tools <command tag="palette">palette</command>, or one of the <glossary tag="paint tool">paint tools</glossary> from the Paint <command tag="palette">palette</command>. The basic <glossary tag="tool">tools</glossary> are:</p><p></p><p>&#9;* <b>browse</b>: perform actions such as clicking buttons and typing in fields</p><p>&#9;* <b>pointer</b>: <command tag="select">select</command>, move, or resize objects</p><p>&#9;* <b>button</b>: create all styles of button objects</p><p>&#9;* <b>field</b>: create all styles of <keyword tag="field">field</keyword> objects</p><p>&#9;* <b>scrollbar</b>: create all styles of scrollbar objects</p><p>&#9;* <b>graphic</b>: create all styles of <keyword tag="graphic">graphic</keyword> objects</p><p>&#9;* <b>image</b>: create paint images</p><p>&#9;* <b>player</b>: create sound and video player objects</p><p></p><p>The paint tools are:</p><p>&#9;* <b>select</b>: <command tag="select">select</command> a rectangle in an image</p><p>&#9;* <b>pencil</b>: draw freehand in an image</p><p>&#9;* <b>bucket</b>: fill a shape in an image</p><p>&#9;* <b>brush</b>: draw brushstrokes in an image</p><p>&#9;* <b>eraser</b>: erase an area in an image</p><p>&#9;* <b>spray can</b>: draw airbrush strokes in an image</p><p>&#9;* <b>rectangle</b>: draw a rectangle or square shape</p><p>&#9;* <b>line</b>: draw a straight line in an image</p><p>&#9;* <b>round rect</b>: draw a rectangle with rounded corners in an image</p><p>&#9;* <b>oval</b>: draw an oval or circle shape in an image</p><p>&#9;* <b>polygon</b>: draw a <keyword tag="polygon">polygon</keyword> in an image</p><p>&#9;* <b>curve</b>: draw a curved line in an image</p><p>&#9;* <b>regular polygon</b>: draw a <keyword tag="regular">regular polygon</keyword> shape in an image</p><p>&#9;* <b>dropper</b>: pick up a color from an image</p><p></p><p><b>Comments:</b></p><p>The tool you choose is effective for all editable windows, until you choose another tool. (The Browse tool is always in effect for stacks whose <b>cantModify</b> <glossary tag="property">property</glossary> is true, and for <function tag="stacks">stacks</function> being displayed as a <command tag="palette">palette</command>, <glossary tag="modeless dialog box">modeless dialog</glossary>, or <glossary tag="modal dialog box">modal dialog</glossary>.)</p><p></p><p>All types of graphics are drawn with the single Graphic tool. To draw a specific shape, first draw with the Graphic tool, then set the <b>style</b> <glossary tag="property">property</glossary> of the new <keyword tag="graphic">graphic</keyword> to the shape you want. (You can also set the <property tag="style">style</property> of the <keyword tag="templateGraphic">templateGraphic</keyword> to the shape you want, then draw the <keyword tag="graphic">graphic</keyword> with the Graphic <function tag="tool">tool</function>. The <keyword tag="graphic">graphic</keyword> icons on the Tools <command tag="palette">palette</command> work this way: each one sets the <property tag="style">style</property> of the <keyword tag="templateGraphic">templateGraphic</keyword>, then chooses the Graphic tool.)</p><p></p><p>Similarly, all types of buttons, fields, and scrollbars can be drawn with the single tool for that object type. You specify a particular kind of button, field, or scrollbar by setting its <b>style</b> <glossary tag="property">property</glossary>.</p><p></p><p></p><p></p><p></p><p></p><note>You must choose <glossary tag="tool">tools</glossary> by name. The <keyword tag="top">HyperCard</keyword> method of choosing <glossary tag="tool">tools</glossary> by number is not supported in LiveCode.</note></description>
</doc>