mobileControlCreate

Typecommand
DictionaryLCS
LibraryLiveCode Script
Syntax
mobileControlCreate <controlType> [, <controlName> ]
Synonymsiphonecontrolcreate
Summary

Creates a native iOS or Android control.

Introduced4.6
OSios, android
Platformsmobile
Parameters
NameTypeDescription
controlType

The type of control to create.

browser: Native iOS or Android web browser control
scroller: Native iOS or Android scroller control
player: Native iOS or Android player control
input: Native iOS or Android text input control
multiline: Native iOS or Android multi-line text control
controlName

Optional string to use to identify the control. The controlName must be unique amongst all existing controls and cannot be an integer.

Example
mobileControlCreate "browser"
mobileControlCreate "scroller", "myFirstScroller"
put "input" into tControlType
mobileControlCreate tControlType, "myFirstInputField"
mobileControlCreate "player", "myFirstPlayer"
mobileControlSet "myFirstPlayer", "visible", true
mobileControlSet "myFirstPlayer", "rect", "50,50,500,500"
mobileControlSet "myFirstPlayer", "filename", specialFolderPath("engine") \
      & "/movie.mp4"
mobileControlDo "myFirstPlayer", "play"
mobileControlCreate "multiline", "myMultiLineTextInput"
Values
NameTypeDescription
The result

The unique (numeric) id for the new control is returned in the result.

RelatedCommand: mobileControlDelete, mobileControlDo, mobileControlSet
Function: mobileControlGet, mobileControlTarget, result, mobileControls
Description

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

Native mobile iOS and Android controllers can only be created dynamically in script.

To destroy a native control use: mobileControlDelete

To configure a native control use: mobileControlSet

To read a property of a native control use: mobileControlGet

To control the behavior of a native control use: mobileControlDo

Note: If a player is created with an invalid filename or if the file is missing, the video controller will display incorrectly. To check if a player is set up correctly, the following code could be used:

if mobileControlGet(sPlayerID, "duration")  0 then
    answer "Player is not initialised correctly"
end if