<doc>
	<legacy_id>1034</legacy_id>
	<name>label</name>
	<type>property</type>

	<syntax>
		<example>set the label of <i>object</i> to <i>labelString</i></example>
	</syntax>

	<synonyms>
		<synonym>title</synonym>
	</synonyms>

	<summary>Specifies the <keyword tag="string">string</keyword> shown in a <glossary tag="stack window">stack window's</glossary> <glossary tag="title bar">title bar</glossary>, or a text label to be displayed on the specified <glossary tag="object">object</glossary> if its <property tag="showName">showName</property> <glossary tag="property">property</glossary> is true.</summary>

	<examples>
<example>set the label of button 1 to &quot;Hello&quot; &amp; return &amp; &quot;World&quot;</example>
<example>get the label of button &quot;Choices Popup&quot; <i><a name="code tag=">-- current menu choice</a></i></example>
<example><p>set the label of this stack to the short name of this card</p></example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.5">Now always native encoding</changed>
	</history>

	<objects>
		<stack/>
		<group/>
		<button/>
		<graphic/>
	</objects>

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

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

	<security>
	</security>


	<classification>
		<category>Windows &amp; Dialog Boxes</category>
		<category>Appearance &amp; Positioning</category>
	</classification>

	<references>
		<property tag="menuHistory">menuHistory Property</property>
		<property tag="acceleratorText">acceleratorText Property</property>
		<property tag="titleWidth">titleWidth Property</property>
		<property tag="longWindowTitles">longWindowTitles Property</property>
		<property tag="unicodeTitle">unicodeTitle Property</property>
		<keyword tag="effective">effective Keyword</keyword>
	</references>

	<description>
	<overview>Use the <b>label</b> <glossary tag="property">property</glossary> as a user-visible replacement for an ungainly <property tag="name">name</property>, or to change the visible name of a window or <glossary tag="object">object</glossary> when changing the actual <property tag="name">name</property> would require changing code that refers to it.</overview>

		<parameters>
		</parameters>

	<value>The <b>label</b> of an <glossary tag="object">object</glossary> is a <keyword tag="string">string</keyword>.<p></p><p>By default, the <b>label</b> <glossary tag="property">property</glossary> of newly created <glossary tag="button">buttons</glossary>, <glossary tag="graphic">graphics</glossary>, <glossary tag="group">groups</glossary>, and <function tag="stacks">stacks</function> is set to empty.</p></value>
	<comments>If a button's <b>menuMode</b> is either &quot;option&quot; or &quot;comboBox&quot;, the <glossary tag="button">button's</glossary> <b>label</b> is the text of the currently selected menu option. Setting the <b>label</b> <glossary tag="property">property</glossary> changes the currently selected option. (To change the currently selected option while sending the appropriate <keyword tag="message box">message</keyword>, set the <glossary tag="button">button's</glossary> <property tag="menuHistory">menuHistory</property> instead.)<p></p><p>To create a multiple-line label for a button or graphic, place a <b>return</b> <command tag="constant">constant</command> in the <b>label</b>.</p><p></p><p>If an object's <b>label</b> is empty, the <glossary tag="object">object's</glossary> <property tag="name">name</property> <glossary tag="property">property</glossary> is displayed instead. In this case, the <glossary tag="expression">expression</glossary> <code tag="">the effective label of </code><i>button</i> reports the button's <property tag="name">name</property> <glossary tag="property">property</glossary>.</p><p></p><p>To create a blank title bar, set the stack's <b>label</b> <glossary tag="property">property</glossary> to a space.</p></comments>
	</description>
</doc>