<doc>
	<legacy_id>1634</legacy_id>
	<name>number</name>
	<type>property</type>

	<syntax>
		<example>set the number of <i>card</i> to <i>number</i></example>
		<example>get the number of <i>object</i></example>
	</syntax>

	<synonyms>
		<synonym>num</synonym>
	</synonyms>

	<summary>Specifies an <glossary tag="object">object's</glossary> position within a <keyword tag="file">file</keyword>, a <glossary tag="card">card's</glossary> position within a <object tag="stack">stack</object>, or a <glossary tag="control">control's</glossary> <property tag="layer">layer</property> on a <keyword tag="card">card</keyword>.   </summary>

	<examples>
<example>set the number of this card to 1 </example>
<example>if the number of this card is 1 then go last card</example>
<example><p>put the number of the last button into numberOfButtons</p></example>
	</examples>

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

	<objects>
		<stack/>
		<card/>
		<group/>
		<field/>
		<button/>
		<graphic/>
		<scrollbar/>
		<player/>
		<image/>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
	  <ios/>
    <android/>
  </platforms>

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

	<security>
	</security>


	<classification>
		<category>Objects &amp; Messages</category>
		<category>Navigation &amp; Hypertext</category>
		<category>Appearance &amp; Positioning</category>
	</classification>

	<references>
		<function tag="length">length Function</function>
		<command tag="move">move Command</command>
		<keyword tag="ninth">ninth Keyword</keyword>
		<keyword tag="home">home Keyword</keyword>
		<keyword tag="seconds">seconds Keyword</keyword>
		<message tag="nameChanged">nameChanged Message</message>
	</references>

	<description>
	<overview>Use the <b>number</b> <glossary tag="property">property</glossary> to find out what <property tag="layer">layer</property> a <keyword tag="card">card</keyword> is on, to find or change a <glossary tag="card">card's</glossary> position, or to refer to an <glossary tag="object">object</glossary>.  </overview>

		<parameters>
		</parameters>

	<value>The <b>number</b> of an <glossary tag="object">object</glossary> is a non-negative <keyword tag="integer">integer</keyword>.   <p></p><p>For all objects except cards, the <b>number</b> <glossary tag="property">property</glossary> is read-only and cannot be set.  </p></value>
	<comments>The <b>number</b> of a <keyword tag="control">control</keyword> is its <property tag="layer">layer</property> on the <keyword tag="card">card</keyword>. Lower numbers are further back; higher numbers are farther forward. If you create several <glossary tag="control">controls</glossary> and don't change their <property tag="layer">layer</property> order, the first <keyword tag="control">control</keyword> you created has the <b>number</b> 1 and the rest of the <glossary tag="control">controls</glossary> are numbered in the order of creation. <p></p><p>The <b>number</b> of a <keyword tag="card">card</keyword> specifies its position in the <object tag="stack">stack</object>. When you open a <object tag="stack">stack</object> without specifying a <keyword tag="card">card</keyword>, the <keyword tag="card">card</keyword> whose <b>number</b> is one appears first. Setting the <b>number</b> of a <keyword tag="card">card</keyword> moves it to the specified position in the <object tag="stack">stack</object>. (Cards are the only <glossary tag="object">objects</glossary> whose <b>number</b> <glossary tag="property">property</glossary> can be set. )</p><p></p><p>The <b>number</b> of a <glossary tag="main stack">main stack</glossary> is always zero. The <b>number</b> of a <glossary tag="substack">substack</glossary> is its creation order in the <keyword tag="file">file</keyword>, from 1 to the number of <property tag="substacks">substacks</property>. </p><p></p><p>You can refer to any object by specifying its <b>number</b>. </p></comments>
	</description>
</doc>