<doc>
	<legacy_id></legacy_id>
	<name>orientationChanged</name>
	<type>message</type>

	<syntax>
		<example>orientationChanged</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sent to the current card of the defaultStack when the device detects a change in its position relative to the ground.</summary>

	<examples>
<example><p>on orientationChanged</p><p>   put mobileDeviceOrientation() into theOrientation</p><p>   updateInteface theOrientation -- <i>update the interface to fit the new orientation</i></p><p>end orientationChanged</p></example>
	</examples>

	<history>
		<introduced version="4.5.2">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="4.6.1">4.6.1</changed>
	</history>

	<objects>
	</objects>

	<platforms>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<function tag="mobileDeviceOrientation">mobileDeviceOrientation Function</function>
		<function tag="mobileOrientation">mobileOrientation Function</function>
		<function tag="mobileAllowedOrientations">mobileAllowedOrientations Function</function>
		<command tag="mobileSetAllowedOrientations">mobileSetAllowedOrientations Command</command>
		<command tag="mobileLockOrientation">mobileLockOrientation Command</command>
		<command tag="mobileUnlockOrientation">mobileUnlockOrientation Command</command>
	</references>

	<description>
	<overview>Handle the <b>orientationChanged</b> message if you want to update the position of objects or perform other tasks when the orientation of the device changes.</overview>

		<parameters>
		</parameters>

	<value></value>
	<comments>The <b>orientationChanged</b> message is sent to the current card of the defaultStack when the device detects a change in its position relative to the ground. You can use the <function tag="mobileDeviceOrientation">mobileDeviceOrientation</function> function to find out the current orientation.<p></p><p>The <b>orientationChanged</b> message is sent before any automatic interface rotation takes place thus changes to the orientation lock state and allowed set can be made at this point and still have an effect. If you wish to perform an action after the interface has been rotated, then either do so on receipt of <message tag="resizeStack">resizeStack</message>, or by using a <command tag="send">send in 0 milliseconds</command> command.</p></comments>
	</description>
</doc>