TextBox2

Use a TextBox widget to enable a user to enter single line of text. For example, you can add TextBox widgets to the Login page of an application to enable users to enter their login credentials.

To learn how to use this widget programmatically, refer Quantum Visualizer Widget guide.

Look Properties

Look properties define the appearance of the widget. The following are the major properties you can set:

For descriptions of the properties available on the Look tab of the Properties pane, see Look.

Skin Properties

Skin properties define a skin for the widget, including background color, borders, and shadows. If the widget includes text, you can also specify the text font.

For the TextBox widget, you can apply a skin and its associated properties for the following states:

Skin Definition
Normal The default skin of a widget.
Focus The skin applied when the widget has the focus.
Blocked UI

The skin applied to block the interface until the action in progress (for example, a service call) is completed.

Note: The Blocked UI skin is available only for SPA platforms.

Placeholder The skin applied to placeholder text in the widget. Only the font color skin attribute is applicable.
Hover Skin

Tthe look and feel of a widget when the cursor hovers over the widget.

Note: The Hover skin is available only on the Windows (native) Tablet platform.

For more information about applying skins, see Understanding Skins and Themes.

TextBox Properties

TextBox properties specify properties that are available on any platform supported by Quantum Visualizer, and assign platform-specific properties.

Note: In this section, the properties that can be forked are identified by an icon located to the left of the property. For more information, see Fork a Widget Property.

Mask Text

Specifies whether the text entered by the user is hidden by a mask character, such as asterisk or dot. This is typically enabled for a text box used to enter secure information, such as a password.

Default: Off (Mask Text is disabled)

Max Characters

Specifies the maximum number of characters that a user can enter in the text box.

Input Mode

Specifies whether the text area accepts any characters or only numeric values.

Height Mode

Specifies how the text box height is determined, either by the intrinsic content or the system default. The default option is available only for iPhone and SPA platforms.

To provide a platform-specific or default value, click the Ellipsis button (...) to open the Height Mode dialog box, and then select a value.

Container Height

Specifies the dimensions of the text box, based on the Height Reference option. This property is available for non-flex forms when the Height Mode is Custom.

Height Reference

Specifies how the text box dimensions are determined:

View Type

Specifies whether the text box can be used as a search field. The default setting is a text field.

The selected view type becomes the default for all the platforms. To provide a platform-specific value or a different default value, click the Ellipsis button (...) to open the View Type dialog box, and then select a value.

Keyboard Style

Specifies the style of keyboard displayed when a user enters text or numeric values in the text area.

Note: This property is specific to the Android platform.

Placeholder

Specifies placeholder text for the text area; for example, a hint that describes what should be entered.

Auto Capitalize

Specifies the character capitalization behavior.

Following are the options available:

Auto Filter

Specifies whether characters entered in the text box are matched against the filter list, and possible matches are displayed.

Default: Off (input characters are not matched against the filter list)

Auto Correct

Specifies whether auto-correction is enabled. Click the ellipsis (...) button to make the Auto Correct property setting platform-specific.

Note: You cannot execute this property on the Visualizer Canvas.

Note: This property is specific to the SPA platform.

Pasteboard Type

Enables an application to share data within the application or with another application using system-wide or application-specific paste boards.

Typically, an object in the application writes data to a pasteboard when the user requests a copy or cut operation on a selection in the user interface. Another object in the same or different application then reads that data from the pasteboard and presents it to the user at a new location; this usually happens when the user requests a paste operation.

Note: You can only paste the text to a text box with the same pasteboard type as that of the source textbox. For example, if you set the Pasteboard type as App Level Persistent , you can paste the text only to another text box whose pasteboard type is also set to App Level Persistent .

Note: This property is specific to the iOS platform.

Close Button

Specifies whether the keypad window displays a Done button.

Note: This property is specific to the iOS platform.

Close Button Text

Specifies alternate text for the "Done" button. This property is available only when the Close Button is enabled.

Note: This property is specific to the iOS platform.

Clear Button

Specifies whether the keypad window displays a Clear button that clears text in the text box.

Note: This property is specific to the iOS platform.

Progress Indicator

Specifies whether to display a progress indicator showing that widget content is being loaded.

Note: This property is specific to the iOS platform.

Keyboard Action Label

Specifies the text displayed on the action key of the keyboard.

Default: Done

Note: This property is specific to iOS and Android platform.

Left Image

Specifies an image displayed on the left side of the text box. For example, use a magnifying glass image to indicate the text box is used as a search field:

To select an image, click the Edit button to open the LeftViewImage dialog box, and then select an available image or provide an image URL.

Note: This property is specific to the iOS platform.

Done Go Search Next
Send Google Join Route
Yahoo Call    

Auto Complete

Specifies whether characters entered in the text box are matched against a dictionary of words, and word suggestions are displayed.

Default: Off (word suggestions are not displayed)

Note: This property is specific to the SPA platform.

Tool Tip

For the Windows Tablet platform, specifies a message that displays when you hover the mouse pointer over the widget .

Actions

Actions define what happens when an event occurs. On a TextBox widget, you can run an action when the following events occur:

For more information, see Add Actions.

Placement Inside a Widget

The following table summarizes where a TextBox2 widget can be placed:

Flex Form Yes
VBox Form Yes
FlexContainer Yes
FlexScrollContainer Yes
HBox Yes
VBox Yes
ScrollBox Horizontal Orientation - Yes
Vertical Orientation- Yes
Tab Yes
Segment No
Popup Yes
Template

 

Header- No
Footer- No

Widget Appearance on Platforms

The appearance of the TextBox2 widget varies as follows:

Platform Appearance
Android
iOS
SPA

 

 

 

 

 

Rev Author Edits
8 SHS SHS
7.2.1 SHS SHS
Copyright © 2020 Temenos. All rights reserved.