<doc>
	<legacy_id>1299</legacy_id>
	<name>select</name>
	<type>command</type>

	<syntax>
		<example>select [before | after] {text |<i> chunk</i>} of <i>field</i></example>
		<example>select empty</example>
		<example>select <i>objectList</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary><glossary tag="select">Selects</glossary> part of the text of a <keyword tag="field">field</keyword>, or places the <glossary tag="insertion point">insertion point</glossary> in a <keyword tag="field">field</keyword>, or removes the <glossary tag="insertion point">insertion point</glossary>, or <glossary tag="select">Selects</glossary> one or more <glossary tag="object">objects</glossary>.</summary>

	<examples>
<example>select text of field "output"</example>
<example>select after word 34 of field "output"</example>
<example><p>select empty</p></example>
<example>select button "next"</example>
<example>select scrollbar "progress" and graphic "background" and field "output"</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/>
		<ios/>
		<android/>
	</platforms>

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

	<security>
	</security>


	<classification>
		<category>User Interaction</category>
	</classification>

	<references>
		<function tag="selectedChunk">selectedChunk Function</function>
		<function tag="selectedLoc">selectedLoc Function</function>
		<command tag="copy">copy Command</command>
		<command tag="hilite">hilite Command</command>
		<command tag="focus">focus Command</command>
		<command tag="delete">delete Command</command>
		<property tag="selectGroupedControls">selectGroupedControls Property</property>
		<keyword tag="intersect">intersect Keyword</keyword>
		<message tag="openField">openField Message</message>
		<message tag="selectionChanged">selectionChanged Message</message>
	</references>

	<description>Use the <b>select</b> <glossary tag="command">command</glossary> to <command tag="select">select</command> <glossary tag="object">objects</glossary> or text in order to change them, or to deselect all <glossary tag="object">objects</glossary> and text.<p></p><p><b>Parameters:</b></p><p>The <i>chunk</i> is a <glossary tag="chunk expression">chunk expression</glossary> specifying a portion of the <i>field</i>.</p><p></p><p>The <i>field</i> is a field reference.</p><p></p><p>The <i>objectList</i> consists of one or more object references, separated by the word and.</p><p></p><p><b>Comments:</b></p><p>If you select text in a field, the field scrolls (if necessary) to show the selected chunk.</p><p></p><p>Use the select before or select after form to position the insertion point at a particular location in a field.</p><p></p><p>Use the select empty form to deselect all objects and text. To select an object without deselecting any objects that are already selected, use the <b>selected</b> <glossary tag="property">property</glossary> instead of the <b>select</b> <glossary tag="command">command</glossary>.</p><p></p><p>To select lines in a list field, set the field's <b>hilitedLine</b> <glossary tag="property">property</glossary> instead of using the <b>select</b> <glossary tag="command">command</glossary>.</p><p></p><p>To change the selection in an option menu or combo box use the  property instead of the  command.</p><p></p><p>To select text in a field, the field's <b>traversalOn</b> <glossary tag="property">property</glossary> must be set to true.</p></description>
</doc>