EmailPicker

Definition

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

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).

Enabled

If set, user can enter text into the EmailPicker.

FontBold

Specifies whether the text of the EmailPicker should be bold. Some fonts do not support bold.

FontItalic

Specifies whether the text of the EmailPicker should be italic. Some fonts do not support italic.

FontSize

Specifies the text font size of the EmailPicker, measured in sp(scale-independent pixels).

FontTypeface

The text font face of the EmailPicker. Valid values are 0 (default), 1 (serif), 2 (sans serif), or 3 (monospace).

Height

Specifies the EmailPicker’s vertical height, measured in pixels.

HeightPercent

Specifies the EmailPicker’s vertical height as a percentage of the Screen’s Height.

Hint

EmailPicker hint for the user.

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).

TextAlignment

Specifies the alignment of the EmailPicker’s text. Valid values are: 0 (normal; e.g., left-justified if text is written left to right), 1 (center), or 2 (opposite; e.g., right-justified if text is written left to right).

TextColor

Specifies the text color of the EmailPicker as an alpha-red-green-blue integer.

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 Screen’s Width.