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

	<syntax>
		<example>set the fullscreenmode of <i>stack</i> to {empty|"exactFit"|"letterbox"|"noBorder"|"noScale"|"showAll"}</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sets the full screen scaling mode of a stack.</summary>

	<examples>
<example>set the fullscreenmode of this stack to empty</example>
<example>set the fullscreenmode of this stack to "noScale"</example>
	</examples>

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

	<objects>
	</objects>

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

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

	<security>
	</security>


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

	<references>
	</references>

	<description>
	<overview>Use the <b>fullscreenmode</b> property to choose the most appropriate full screen scaling mode for the application.</overview>

		<parameters>
  <parameter>
    <name>empty</name>
    <description>The stack is resized (not scaled) to fit the screen. (default) This is the existing behavior.</description>
  </parameter>
  <parameter>
    <name>"exactFit"</name>
    <description>Scale the stack to fill the screen. This stretches the stack if the aspect ratio of the screen does not match that of the stack.</description>
  </parameter>
  <parameter>
    <name>"letterbox"</name>
    <description>Scale the stack, preserving the aspect ratio, so all content is visible. Some blank space may remain if the screen and stack aspect ratios do not match.</description>
  </parameter>
  <parameter>
    <name>"noBorder"</name>
    <description>Scale the stack to fill the screen, preserving the aspect ratio. If the stack and screen aspect ratios do not match, the left / right or top / bottom extremes of the stack are not visible.</description>
  </parameter>
  <parameter>
    <name>"noScale"</name>
    <description>The stack is not scaled, but is centered on the screen instead.</description>
  </parameter>
<parameter>
    <name>"showAll"</name>
    <description>Scale the stack preserving aspect ratio so all content within the stack rect is visible. Portions of the stack outside the stack rect will be visible if the scaled stack does not fit the screen exactly.</description>
  </parameter>		</parameters>

	<value>The <b>fullscreenmode</b> returns the mode to which this property is set.</value>
	<comments>There are multiple ways in which a stack can be resized or scaled to take full advantage of the available screen space. <b>fullscreenmode</b> allows the developer to choose the most appropriate for their application.<p></p><p></p><note>The fullscreenmode only takes affect when a stack is full screen. This is the case on mobile platforms where stacks are always full screen, or on the desktop when the <property tag="fullscreen">fullscreen</property> property of the stack is set to true.</note><p></p><p>The full screen scaling mode is available on all desktop and mobile platforms and operates independently from Hi-DPI support.</p><p>        </p></comments>
	</description>
</doc>