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

	<syntax>
		<example>mobileControlCreate controlType [, <i>name</i> ]</example>
	</syntax>

	<synonyms>
		<synonym>iphoneControlCreate</synonym>
	</synonyms>

	<summary>Creates a native iOS or Android control.</summary>

	<examples>
<example>mobileControlCreate &quot;browser&quot;</example>
<example>mobileControlCreate &quot;scroller&quot;, &quot;myFirstScroller&quot;</example>
<example><p>put &quot;input&quot; into tControlType</p><p>mobileControlCreate tControlType, &quot;myFirstInputField&quot;</p></example>
<example><p>mobileControlCreate &quot;player&quot;, &quot;myFirstPlayer&quot;</p><p>mobileControlSet &quot;myFirstPlayer&quot;, &quot;visible&quot;, true</p><p>mobileControlSet &quot;myFirstPlayer&quot;, &quot;rect&quot;, &quot;50,50,500,500&quot;</p><p>mobileControlSet &quot;myFirstPlayer&quot;, &quot;filename&quot;, specialFolderPath(&quot;engine&quot;) &amp; &quot;/movie.mp4&quot;</p><p>mobileControlDo &quot;myFirstPlayer&quot;, &quot;play&quot;</p></example>
<example>mobileControlCreate &quot;multiline&quot;, &quot;myMultiLineTextInput&quot;</example>
	</examples>

	<history>
		<introduced version="4.6">Added</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.5.1">Updated to include support for Android scroller, player, text input and multiline</changed>
<changed version="5.5">Changed to mobileControlCreate from iPhoneControlCreate and added Android Browser support</changed>
<changed version="4.6.4">Added support for Multi-line Native Text Field</changed>
	</history>

	<objects>
		<iosScroller/>
		<iosBrowser/>
		<iosPlayer/>
		<iosTextInput/>
		<AndroidScroller/>
		<AndroidBrowser/>
		<AndroidPlayer/>
		<androidTextInput/>
		<androidMultiline/>
	</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="mobileControlDelete">mobileControlDelete Command</command>
		<command tag="mobileControlDo">mobileControlDo Command</command>
		<command tag="mobileControlSet">mobileControlSet Command</command>
	</references>

	<description>
	<overview>Low-level support has been added for creating and manipulating some native mobile controls (views) on iOS and Android.</overview>

		<parameters>
  <parameter>
    <name>controlType</name>
    <description>The type of control to create from among the following.</description>
    <options title="">
      <option>
        <item>browser</item>
        <description>Native iOS or Android web browser control</description>
      </option>
      <option>
        <item>scroller</item>
        <description>Native iOS or Android scroller control</description>
      </option>
      <option>
        <item>player</item>
        <description>Native iOS or Android player control</description>
      </option>
      <option>
        <item>input</item>
        <description>Native iOS  or Android text input control</description>
      </option>
      <option>
        <item>multiline</item>
        <description>Native iOS or Android multi-line text control</description>
      </option>
    </options>
  </parameter>
  <parameter>
    <name>name</name>
    <description>Optional string to use to identify the control. The <i>name</i> must be unique amongst all existing controls and cannot be an integer.</description>
  </parameter>		</parameters>

	<value>The unique (numeric) id for the new control is returned in <function tag="result">the result</function>.</value>
	<comments>Native mobile iOS and Android controllers can only be created dynamically in script. <p></p><p>To destroy a native control use: <command tag="mobileControlDelete">mobileControlDelete</command></p><p>To configure a native control use: <command tag="mobileControlSet">mobileControlSet</command></p><p>To read a property of a native control use: <command tag="mobileControlSet">mobileControlGet</command></p><p>To control the behavior of a native control use: <command tag="mobileControlDo">mobileControlDo</command></p></comments>
	</description>
</doc>