<doc>
	<legacy_id>1579</legacy_id>
	<name>textStyle</name>
	<type>property</type>

	<syntax>
		<example>set the textStyle of <i>object</i> to {empty | plain |<i> stylesList</i>}</example>
		<example>set the textStyle of [<i>chunk</i> of] <i>field</i> to {empty | plain |<i> stylesList</i>}</example>
		<example>set the textStyle[<i>style</i>] of object to {true | false}</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies the style or styles applied to text in an <glossary tag="object">object</glossary>.</summary>

	<examples>
<example>set the textStyle of line 2 of field "Choices" to "italic,underline"</example>
<example>set the textStyle of the selectedChunk to "box"</example>
<example><p>set the textStyle of button "Off" to "italic,bold"</p></example>
<example>set the textStyle["bold"] of field "name" to true</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.5">No longer causes the other text properties to be set</changed>
<changed version="1.1">1.1</changed>
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</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>Appearance &amp; Positioning</category>
	</classification>

	<references>
		<function tag="fontStyles">fontStyles Function</function>
		<keyword tag="box">box Keyword</keyword>
		<keyword tag="italic">italic Keyword</keyword>
	</references>

	<description>
	<overview>Use the <b>textStyle</b> <glossary tag="property">property</glossary> to change the appearance of text.</overview>

		<parameters>
		</parameters>

	<value>The <b>textStyle</b> of an <glossary tag="object">object</glossary> or <glossary tag="chunk">chunk</glossary> is either "plain", empty, "mixed", or one or more of the following, separated by commas:<p>        * <b>bold</b></p><p>        * <i>italic</i></p><p>        * <u>underline</u></p><p>        * strikeout</p><p>        * <b>box</b></p><p>        * threeDbox</p><p>        * link (or group)</p></value>
	<comments>Setting the <b>textStyle</b> to "plain" turns off all styles. (Setting the <b>textStyle</b> to "plain" plus one or more additional styles may result in anomalous behavior.)<p></p><p>Setting the <b>textStyle</b> of an <glossary tag="object">object</glossary> to empty allows the <b>textStyle</b> of the <glossary tag="object">object's</glossary> <property tag="owner">owner</property> to show through. Use the <keyword tag="effective">effective</keyword> <glossary tag="keyword">keyword</glossary> to find out what style is used for the <glossary tag="object">object</glossary>, even if its own <b>textStyle</b> is empty. Similarly, use the <keyword tag="effective">effective</keyword> <glossary tag="keyword">keyword</glossary> to find out what style is used for a <glossary tag="chunk">chunk</glossary> of text, even if the <glossary tag="chunk">chunk's</glossary> <property tag="textStyle">textStyle</property> is empty.</p><p></p><p>If you request the <b>textStyle</b> of a <glossary tag="chunk">chunk</glossary> which includes multiple style runs--for example, some bold and some plain text--the <glossary tag="property">property</glossary> reports "mixed".</p><p></p><p>The "link" style can be used only for chunks of a field, not for objects. Setting the <b>textStyle</b> of a <glossary tag="chunk">chunk</glossary> to "link" turns it into a <glossary tag="grouped text">text group</glossary>.</p><p></p><p></p><p></p><change>The "link" style was introduced in version 1.1. In previous versions, the term "group" was used. The term "group" is still available as a partial synonym: setting the <b>textStyle</b> of a <glossary tag="chunk">chunk</glossary> to "group" sets it to "link".<p></change><p></p><change>As of<b> </b>version 5.0.2 a new array variant of the <b>textStyle</b> property has been added allowing for access to individual textStyles independently from the others by specifying the required style as an array key.<p></change><p>&#9;the <b>textStyle</b>[&lt;style&gt;]</p><p></p><p>Here, style can be one of bold, condensed, expanded, italic, oblique, box, threedbox, underline, strikeout, link. For example</p><p>&#9;</p><p>&#9;set the <b>textStyle</b>["bold"] of field 1 to true</p><p>&#9;</p><p>&#9;</p></comments>
	</description>
</doc>