<doc>
  <name>measureText</name>
  <type>function</type>
  <syntax>
    <example>measureText(<i>text</i>,<i>object reference</i>,[<i>mode</i>])</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <function tag="measureUnicodeText">measureUnicodeText Function</function>
    <property tag="formattedWidth">formattedWidth Property</property>
    <property tag="formattedHeight">formattedHeight Property</property>
  </references>
  <history>
    <introduced version="6.5">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary><glossary tag="return">Returns</glossary> the width, size or bounds of the text drawn with the effective font attribute of the given object.</summary>
  <examples>
    <example>put measureText(theText,me) into theTextWidth</example>
    <example>put measureText(theText,me,"size") into theTextSize</example>
    <example>put measureText(theText,me,"bounds") into theTextBounds</example>
  </examples>
  <description>
    <p>Use the <b>measureText</b> <control_st tag="function">function</control_st> to find the dimensions of text drawn with the effective font attributes of an object.</p><p><b>Parameters:</b></p><p>The <i>text</i> is any native string. For unicode strings use <function tag="measureUnicodeText">measureUnicodeText</function>.</p><p>The <i>object reference</i> is an expression that evaluates to an object reference.</p><p>The <i>mode</i> is one of:</p>
	<ul>
		<li>width - (default if not specified) - returns the width of the text</li>
		<li>size - returns the width,height of the text</li>
		<li>bounds - returns a rectangle identifying the bounds of the text in the form 0,-ascent,width,descent where ascent and descent are relative to a 0 baseline the text is drawn on.</li>
	</ul>
  </description>
</doc>