EmailPicker

Last Updated On 2021-07-16

Version 3MinSDK 7Tutorial Video

An EmailPicker is a kind of text box. If the user begins entering the name or email address of a contact, the phone will show a dropdown menu of choices that complete the entry. If there are many contacts, the dropdown can take several seconds to appear, and can show intermediate results while the matches are being computed.

The initial contents of the text box and the contents< after user entry is in the Text property. If the Text property is initially empty, the contents of the Hint property will be faintly shown in the text box as a hint to the user.

Other properties affect the appearance of the text box (TextAlignment, BackgroundColor, etc.) and whether it can be used (Enabled).

Text boxes like this are usually used with Button components, with the user clicking on the button when text entry is complete.

Properties

You can set the below properties in the UI part of the builder.

  • BackgroundColor - it's a color value which is set to &h00000000 by default.
  • CustomFontTypeFace - it's a asset value which is set to blank by default.
  • Enabled - it's a boolean value which is set to true by default.
  • FontBold - it's a boolean value which is set to false by default.
  • FontItalic - it's a boolean value which is set to false by default.
  • FontSize - it's a non negative float value which is set to 14.0 by default.
  • FontTypeface - it's a typeface value which is set to 0 by default.
  • HeihMargin - it's a four value which is set to 0,0,0,0 by default.
  • HeihPadding - it's a four value which is set to 0,0,0,0 by default.
  • Hint - it's a string value which is set to blank by default.
  • MarginBottom - it's a non negative float value which is set to 0 by default.
  • MarginLeft - it's a non negative float value which is set to 0 by default.
  • MarginRight - it's a non negative float value which is set to 0 by default.
  • MarginTop - it's a non negative float value which is set to 0 by default.
  • PaddingBottom - it's a non negative float value which is set to 0 by default.
  • PaddingLeft - it's a non negative float value which is set to 0 by default.
  • PaddingRight - it's a non negative float value which is set to 0 by default.
  • PaddingTop - it's a non negative float value which is set to 0 by default.
  • Text - it's a textArea value which is set to blank by default.
  • TextAlignment - it's a textalignment value which is set to 0 by default.
  • TextColor - it's a color value which is set to &hff000000 by default.
  • Visible - it's a visibility value which is set to true by default.

Block Properties

You can set the below blocks properties in the blocks section of the builder.

BackgroundColor

The background color of the input box. 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).


CustomFontTypeFace

Sets the custom font


Enabled

Whether the user can enter text into the EmailPicker. By default, this is true.


FontSize

The font size for the text. By default, it is 14.0 points.


Height

Specifies the vertical height of the EmailPicker, measured in pixels.


HeightPercent

Specifies the vertical height of the EmailPicker as a percentage of the height of the Screen.


Hint

Text that should appear faintly in the EmailPicker to provide a hint as to what the user should enter. This can only be seen if the Text property is empty.


MarginBottom

Property for MarginBottom


MarginLeft

Property for MarginLeft


MarginRight

Property for MarginRight


MarginTop

Property for MarginTop


PaddingBottom

Property for PaddingBottom


PaddingLeft

Property for PaddingLeft


PaddingRight

Property for PaddingRight


PaddingTop

Property for PaddingTop


Text

Returns the textbox contents.


TextColor

The color for the text. You can choose a color by name in the Designer or in the Blocks Editor. The default text color is black.


Visible

Specifies whether the EmailPicker should be visible on the screen. Value is true if the EmailPicker is showing and false if hidden.


Width

Specifies the horizontal width of the EmailPicker, measured in pixels.


WidthPercent

Specifies the horizontal width of the EmailPicker as a percentage of the width of the Screen.



Methods

You can set the below method blocks in the blocks section of the builder.

RequestFocus

Sets the EmailPicker active.


Events

You can set the below event blocks in the blocks section of the builder.

GotFocus

Event raised when the `EmailPicker` is selected for input, such as by the user touching it.

LostFocus

Event raised when the EmailPicker is no longer selected for input, such as if the user touches a different text box.