<doc>
	<legacy_id>2082</legacy_id>
	<name>textSize</name>
	<type>property</type>

	<syntax>
		<example>set the textSize of <i>object</i> to <i>pointSize</i></example>
		<example>set the textSize of [<i>chunk</i> of] <i>field</i> to <i>pointSize</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies the <keyword tag="point">point</keyword> size of text displayed by an <glossary tag="object">object</glossary>.</summary>

	<examples>
<example>set the textSize of card &quot;Intro&quot; to 24</example>
<example>set the textSize of word 1 of field ID 3 to 9</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.0">No longer causes the other text properties to be set</changed>
	</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  Positioning</category>
	</classification>

	<references>
		<property tag="fixedLineHeight">fixedLineHeight Property</property>
		<property tag="HTMLText">HTMLText Property</property>
		<property tag="printTextSize">printTextSize Property</property>
		<property tag="textAlign">textAlign Property</property>
	</references>

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

		<parameters>
		</parameters>

	<value>The <b>textSize</b> of an <glossary tag="object">object</glossary> or <glossary tag="chunk">chunk</glossary> is either empty or an integer greater than 4.</value>
	<comments>Setting the <b>textSize</b> of an <glossary tag="object">object</glossary> to empty allows the <b>textSize</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 size is used for the <glossary tag="object">object</glossary>, even if its own <b>textSize</b> is empty.<p></p><p>The <b>textSize </b>of an object defines the height of the text and is specified in <i>points</i>. The engine ensures that this is equivalent to <i>pixels, </i>for example, if you set the <b>textSize </b>of a field to <i>8 points</i>, then the engine outputs text that is <i>8 pixels high</i> on all platforms. The height of the text is measured from the bottom of the lowest reaching character to the top of the highest reaching character.</p><p></p><p></p><note>The <property tag="textHeight">textHeight</property> of an object is like the line spacing, it is the amout of space between the lines, not the height of the actual text.</note></comments>
	</description>
</doc>