<doc>
  <legacy_id>1752</legacy_id>
  <name>height</name>
  <type>property</type>
  <syntax>
    <example>set the height of <i>object</i> to <i>numberOfPixels</i></example>
  </syntax>
  <library></library>
  <objects>
    <stack/>
    <card/>
    <group/>
    <field/>
    <button/>
    <graphic/>
    <scrollbar/>
    <player/>
    <image/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <command tag="revChangeWindowSize">revChangeWindowSize Command</command>
    <property tag="backSize">backSize Property</property>
    <property tag="orientation">orientation Property</property>
    <property tag="bottom">bottom Property</property>
    <property tag="minHeight">minHeight Property</property>
    <property tag="scale">scale Property</property>
    <property tag="fixedLineHeight">fixedLineHeight Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies the distance from an <glossary tag="object">object's</glossary> top edge to its bottom edge.</summary>
  <examples>
    <example>put the height of button 1 + the height of button 2 into requiredHeight</example>
    <example>set the height of field thisField to the textHeight of thisField</example>
  </examples>
  <description>
    <p>Use the <b>height</b> <glossary tag="property">property</glossary> to determine how much vertical space an <glossary tag="object">object</glossary> needs, or to make it taller or shorter.</p><p/><p><b>Value:</b></p><p>The <b>height</b> of an <glossary tag="object">object</glossary> is a positive integer.</p><p/><p><b>Comments:</b></p><p>If an object's <b>lockLocation</b> <glossary tag="property">property</glossary> is false, when you change its <b>height</b>, it shrinks or grows from the center. The <glossary tag="object">object's</glossary> top and bottom edges both shift, while the <glossary tag="object">object's</glossary> <property tag="location">location</property> <glossary tag="property">property</glossary> stays the same. If the object's <property tag="lockLocation">lockLocation</property> <glossary tag="property">property</glossary> is true, it shrinks or grows from the top left corner: the <glossary tag="object">object's</glossary> top edge stays in the same place, and the bottom edge moves.</p><p/><p>If you reduce the <b>height</b> of a <object tag="stack">stack</object>, some <glossary tag="object">objects</glossary> may end up outside the <object tag="stack">stack</object> window. These <glossary tag="object">objects</glossary> are not shown; however, they are still there, and will be displayed if you make the window tall enough.</p><p/><p>The <b>height</b> of an object cannot be set to zero. Attempting to do so will set the <b>height</b> to 1 instead.</p><p/><p><img src="202652"/> <b>Cross-platform note:</b> On <glossary tag="Mac OS">Mac OS</glossary> and <glossary tag="OS X">OS X systems</glossary>, the <glossary tag="menu bar">menu bar</glossary> normally appears at the top of the screen, rather than inside the <glossary tag="stack window">stack window</glossary>. If a <object tag="stack">stack</object> contains a <glossary tag="menu bar">menu bar</glossary> and the <glossary tag="stack">stack's</glossary> <property tag="editMenus">editMenus</property> <glossary tag="property">property</glossary> is set to false, the <glossary tag="stack window">stack window</glossary> is automatically resized so that the <glossary tag="menu bar">menu bar</glossary> <command tag="group">group</command> is not visible in the window. In this case, the <b>height</b> of the <object tag="stack">stack</object> is the current height of the <glossary tag="stack window">stack window</glossary>., but the height of the card is the height of the total content area of the <object tag="stack">stack</object> (including the hidden <glossary tag="menu bar">menu bar</glossary> <command tag="group">group</command>). This is equal to the <b>height</b> of the <object tag="stack">stack</object> plus its <property tag="vScroll">vScroll</property>.</p><p/><p>You can set the <b>height</b> of a <keyword tag="card">card</keyword>, but doing so has no effect and doesn't change the <glossary tag="card">card's</glossary> <b>height</b> <glossary tag="property">property</glossary>.</p><p/><p><b>Note:</b> The current architecture uses 16-bit signed integers for all co-ordinates, which means that the value range is -32768 to 32767.</p>
  </description>
</doc>