<doc>
	<legacy_id></legacy_id>
	<name>iconGravity</name>
	<type>property</type>

	<syntax>
		<example>set the iconGravity of <i>button</i> to <i>position</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Specifies wether the icon of a button is placed independently of the label.</summary>

	<examples>
<example>set the iconGravity of button "next" to "top"</example>
	</examples>

	<history>
		<introduced version="6.7">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version=""></changed>
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<button/>
	</objects>

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

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

	<security>
	</security>


	<classification>
		<category>Appearance &amp; Positioning</category>
	</classification>

	<references>
		<property tag="icon">icon Property</property>
		<property tag="iconGravity">iconGravity Property</property>
		<property tag="margins">margins Property</property>
		<property tag="borderWidth">borderWidthProperty</property>
	</references>

	<description>
	<overview>Use to <b>iconGravity </b>property to position the icon of a button independent of the label.</overview>

		<parameters>
<parameter>
    <name>button</name>
    <description>A reference or expression that evaluate to an button reference.</description>
  </parameter>
  <parameter>
    <name>position</name>
    <description>A string representing to desired layout of the icon of the button and is one of the following:</description>
<options title="">
<option>
<item>empty</item>
<description>This property has no effect and placement of the icon follows previous engine rules.</description>
</option>

<option>
<item>left</item>
<description>Renders the icon at the middle left side of the button.</description>
</option>

<option>
<item>top</item>
<description>Renders the icon at the middle top of the button.</description>
</option>

<option>
<item>right</item>
<description>Renders the icon at the middle right of the button.</description>
</option>

<option>
<item>bottom</item>
<description>Renders the icon at the middle bottom of the button.</description>
</option>

<option>
<item>topLeft</item>
<description>Renders the icon at the top left of the button.</description>
</option>

<option>
<item>topRight</item>
<description>Renders the icon at the top right of the button.</description>
</option>

<option>
<item>bottomLeft</item>
<description>Renders the icon at the bottom left of the button.</description>
</option>

<option>
<item>bottomRight</item>
<description>Renders the icon at the bottom right of the button.</description>
</option>

<option>
<item>center</item>
<description>Renders the icon in the center of the button.</description>
</option>

<option>
<item>resize</item>
<description>Stretches the icon to fill the button.</description>
</option>

</options>
  </parameter>		</parameters>

	<value>The <b>iconGravity</b> property return a string. By default, the <b>iconGravity</b> property of an button is empty.</value>
	<comments>The margins and borderWidth are taken into account when rendering the icon - the rectangle the icon is placed in is taken to be the button rect after subtracting margins and borderWidth all the way round.</comments>
	</description>
</doc>