EmailPicker Component

Properties

backgroundColor
  The background color of the `EmailPicker``. You can choose a color by name in the Designer or in the Blocks Editor. The default background color is 'default' (shaded 3-D look).
Data type: color
Designer Writable true <emailpicker name="emailpickerName" backgroundColor="FF5bf8a7">
Code Writeable true emailpickerName.backgroundColor = "FF5bf8a7"
Code Readable true let variable = emailpickerName.backgroundColor

enabled
  If set, user can enter text into the EmailPicker.
Data type: boolean
Designer Writable true <emailpicker name="emailpickerName" enabled="true">
Code Writeable true emailpickerName.enabled = true
Code Readable true let variable = emailpickerName.enabled

fontBold
  Specifies whether the text of the EmailPicker should be bold. Some fonts do not support bold.
Data type: boolean
Designer Writable true <emailpicker name="emailpickerName" fontBold="true">
Code Writeable false
Code Readable false

fontItalic
  Specifies whether the text of the EmailPicker should be italic. Some fonts do not support italic.
Data type: boolean
Designer Writable true <emailpicker name="emailpickerName" fontItalic="true">
Code Writeable false
Code Readable false

fontSize
  Specifies the text font size of the EmailPicker, measured in sp(scale-independent pixels).
Data type: number
Designer Writable true <emailpicker name="emailpickerName" fontSize="0">
Code Writeable true emailpickerName.fontSize = 0
Code Readable true let variable = emailpickerName.fontSize

fontTypeface
  The text font face of the EmailPicker. Valid values are 'serif', 'sans serif', or 'monospace'.
Data type: string
Designer Writable true <emailpicker name="emailpickerName" fontTypeface="monospace">
Code Writeable false
Code Readable false

height
  Specifies the EmailPicker's vertical height, measured in pixels.
Data type: number
Designer Writable false
Code Writeable true emailpickerName.height = 120
Code Readable true let variable = emailpickerName.height

heightPercent
  Specifies the EmailPicker's vertical height as a percentage of the Screen's Height.
Data type: number
Designer Writable false
Code Writeable true emailpickerName.heightPercent = 25
Code Readable false

hint
  EmailPicker hint for the user.
Data type: string
Designer Writable true <emailpicker name="emailpickerName" hint="Test hint">
Code Writeable true emailpickerName.hint = "Test hint"
Code Readable true let variable = emailpickerName.hint

text
  The text in the EmailPicker, which can be set by the programmer in the Designer or Blocks Editor, or it can be entered by the user (unless the Enabled property is false).
Data type: string
Designer Writable true <emailpicker name="emailpickerName" text="Test text">
Code Writeable true emailpickerName.text = "Test text"
Code Readable true let variable = emailpickerName.text

textAlignment
  Specifies the alignment of the EmailPicker's text. Valid values are 'left', 'right' and 'center'.
Data type: string
Designer Writable true <emailpicker name="emailpickerName" textAlignment="center">
Code Writeable false
Code Readable false

textColor
  Specifies the text color of the EmailPicker as an red-green-blue-alpha RRGGBBAA or red-green-blue RRGGBB string.
Data type: color
Designer Writable true <emailpicker name="emailpickerName" textColor="FF08b94f">
Code Writeable true emailpickerName.textColor = "FF08b94f"
Code Readable true let variable = emailpickerName.textColor

visible
  Specifies whether the EmailPicker should be visible on the screen. Value is true{
Data type: boolean
Designer Writable true <emailpicker name="emailpickerName" visible="true">
Code Writeable true emailpickerName.visible = true
Code Readable true let variable = emailpickerName.visible

width
  Specifies the horizontal width of the EmailPicker, measured in pixels.
Data type: number
Designer Writable false
Code Writeable true emailpickerName.width = 320
Code Readable true let variable = emailpickerName.width

widthPercent
  Specifies the horizontal width of the EmailPicker as a percentage of the Screen's Width.
Data type: number
Designer Writable false
Code Writeable true emailpickerName.widthPercent = 83
Code Readable false

class
  The styling class of the the component
Data type: string
Designer Writable true <emailpicker name="emailpickerName" class="Test class">
Code Writeable false
Code Readable false

id
  The styling id of the the component
Data type: string
Designer Writable true <emailpicker name="emailpickerName" id="Test id">
Code Writeable false
Code Readable false

name
  The name of the component that will be used to refer to it in code.
Data type: string
Designer Writable true <emailpicker name="emailpickerName" name="testComponent">
Code Writeable false
Code Readable false

Methods

Method name Description Parameters
requestFocus Request focus to current EmailPicker.
emailpickerName.requestFocus()
addEventListener Method used to create event listeners.
See Events below for samples.
eventName string
eventCallbackFunction callback

Events

Event name Description Parameters
gotFocus Event raised when the EmailPicker is selected for input, such as by the user touching it.
emailpickerName.addEventListener(
    "gotFocus",
    function () {
        //Your code here
    }
)
lostFocus Event raised when the EmailPicker is no longer selected for input, such as if the user touches a different text box.
emailpickerName.addEventListener(
    "lostFocus",
    function () {
        //Your code here
    }
)