<doc>
	<legacy_id></legacy_id>
	<name>mobileControlDo</name>
	<type>command</type>

	<syntax>
		<example>mobileControlDo <i>idOrName</i>, action, ...action specific parameters...</example>
	</syntax>

	<synonyms>
		<synonym>iphoneControlDo</synonym>
	</synonyms>

	<summary>Execute specific behaviors of native mobile controls created using <command tag="mobileControlCreate">mobileControlCreate</command>.</summary>

	<examples>
<example>mobileControlDo "myPlayerControl", "play"</example>
<example>mobileControlDo tScrollerControlID, "flashScrollIndicators"</example>
<example><p>mobileControlDo tBrowserControlName, "execute", "alert('javascript browser test')"</p></example>
<example>mobileControlDo tFieldControlName, "focus"</example>
<example><p>// set the focus for a multi-line text field</p><p>mobileControlDo "myMultiLineTextInput", "focus"</p></example>
	</examples>

	<history>
		<introduced version="4.6">Added</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.5.1">Added support for android player and scroller</changed>
<changed version="5.5">Changed to mobileControlDo from iphoneControlDo and updated for the native Android browser</changed>
<changed version="4.6.4">Added support for Multi-line Native Text Field</changed>
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
		<iosScroller/>
		<iosBrowser/>
		<iosPlayer/>
		<iosTextInput/>
		<AndroidBrowser/>
		<AndroidPlayer/>
	</objects>

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

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<function tag="mobileControlGet">mobileControlGet Function</function>
		<function tag="mobileControlTarget">mobileControlTarget Function</function>
		<function tag="mobileControls">mobileControls Function</function>
		<command tag="mobileControlCreate">mobileControlCreate Command</command>
		<command tag="mobileControlDelete">mobileControlDelete Command</command>
		<command tag="mobileControlSet">mobileControlSet Command</command>
	</references>

	<description>
	<overview>Use the <b>mobileControlDo</b> command to execute behaviors specific to a particular native mobile control created using <command tag="mobileControlCreate">mobileControlCreate</command>. An action may require or have a number of optional extra parameters which are defined in the values section below.</overview>

		<parameters>
  <parameter>
    <name>idOrName</name>
    <description>The id or name of the control.</description>
  </parameter>
  <parameter>
    <name>action</name>
    <description>The action to perform.</description>
    <options title="Browser Specific Actions">
      <option>
        <item>advance</item>
        <description>Move forward through the history (wraps the goForward method of UIWebView).</description>
      </option>
      <option>
        <item>retreat</item>
        <description>Move backward through the history (wraps the goBack method of UIWebView).</description>
      </option>
      <option>
        <item>reload</item>
        <description>Reload the current page (wraps the reload method of UIWebView).</description>
      </option>
      <option>
        <item>stop</item>
        <description>Stop loading the current page (wraps the stopLoading method of UIWebView).</description>
      </option>
      <option>
        <item>load baseUrl, htmlText</item>
        <description>Loads as page consisting of the given htmlText with the given baseUrl (wraps theloadHtmlString method of UIWebView). Takes the following additional parameters:</description>
        <values>
          <value>
            <name>baseUrl</name>
            <description/>
          </value>
          <value>
            <name>htmlText</name>
            <description/>
          </value>
        </values>
      </option>
      <option>
        <item>execute, script</item>
        <description>Evaluates the given JavaScript script in the context of the current page (wraps the stringByEvaluationJavaScriptFromString method of UIWebView). Takes the following additional parameter:</description>
        <values>
          <value>
            <name>script</name>
            <description/>
          </value>
        </values>
      </option>
    </options>
    <options title="Scroller Specific Actions (iOS Only)">
      <option>
        <item>flashScrollIndicators</item>
        <description>Makes the scroll indicators flash momentarily.</description>
      </option>
    </options>
    <options title="Player Specific Actions">
      <option>
        <item>play</item>
        <description>Start playing the content of the player.</description>
      </option>
      <option>
        <item>pause</item>
        <description>Pause the content at the current position.</description>
      </option>
      <option>
        <item>stop</item>
        <description>Stop playing the content of the player.</description>
      </option>
      <option>
        <item>prepareToPlay (iOS Only)</item>
        <description>Make the content ready to play, but don't actually commence playback.</description>
      </option>
      <option>
        <item>begin seeking forward (iOS Only)</item>
        <description>Start seeking forward through the content of the player.</description>
      </option>
      <option>
        <item>begin seeking backward (iOS Only)</item>
        <description>Start seeking backward through the content of the player.</description>
      </option>
      <option>
        <item>end seeking (iOS Only)</item>
        <description>Stop seeking through the content of the player.</description>
      </option>
      <option>
        <item>snapshot | snapshot exactly, time, [ maxWidth, maxHeight ] (iOS Only)</item>
        <description>Take a snapshot of the movie at time milliseconds from the beginning. If the 'exactly' form is specified the frame produced is as close as possible to time, otherwise the nearest keyframe is used. The snapshot is made available as a new image object cloned from the templateImage, with data in the format as specified by the global paintCompression property. Takes the following additional parameters:</description>
        <values>
          <value>
            <name>time</name>
            <description>The milliseconds from the beginning.</description>
          </value>
          <value>
            <name>maxWidth (optional)</name>
            <description>If maxWidth and maxHeight are specified, the snapshot is scaled to fit within a rectangle	of that size but preserving the frame's aspect ratio.</description>
          </value>
          <value>
            <name>maxHeight (optional)</name>
            <description>If maxWidth and maxHeight are specified, the snapshot is scaled to fit within a rectangle of that size but preserving the frame's aspect ratio.</description>
          </value>
        </values>
      </option>
    </options>

    <options title="Text Input Specific Actions">
      <option>
        <item>focus</item>
        <description>Focus on the control. On iOS this will also display the keyboard.</description>
      </option>
    </options>

    <options title="Multi-line Text Input Specific Actions">
      <option>
        <item>focus</item>
        <description>Focus on the control. On iOS this will also display the keyboard.</description>
      </option>
    </options>

<options title="Multi-line Text Input Specific Actions (iOS Only)">
      <option>
        <item>scrollRangeToVisible rangeStart, rangeLength</item>
        <description>Ensures the given text range is visible in the view by changing the scroll of the field.</description>
        <values>
          <value>
            <name>rangeStart</name>
            <description>The start index of the text that is to be made visible.</description>
          </value>
          <value>
            <name>rangeLength</name>
            <description>The length of the text that is to be made visible.</description>
          </value>
        </values>
      </option>
    </options>
  </parameter>		</parameters>

	<value></value>
	<comments></comments>
	</description>
</doc>