Input Box

Navigation:  Widget Designer > Widgets >

Input Box

Previous page Return to chapter overview Next page

The InputBox enables you, like the TextBox, to enter text and retrieve the string for further use with the respective member or node.

wd_widget_input-box

To create an InputBox widget choose "Widgets > InputBox". The mouse cursor changes to a crosshair icon, indicating the create mode. With a left-click anywhere on the empty main background window you add the selected widget to the current page. Left-click again if you like to add one more. To quit the create mode, you can switch to the run mode with [F8], where you can use all widgets. Most widgets however need to be set up first.

To edit the InputBox parameters simply right-click on the desired InputBox Widget and choose the menu entry "Item Properties", press [ALT+P] whilst the mouse is hovering above it or double-click on it when being in the edit / move mode ([F9]). The InputBox Property Dialog opens up.

wd_widget_input-box-properties

Name

A unique name can be entered to identify the widget via the Object and Member Notation. The default name is based on the widget type and ID.

Page

This drop-down offers all available pages to place the widget on.

ID
The InputBox ’s ID may be changed by entering a new one in the text field top left. If you change it, you will be asked if you also want to adapt the name to the new ID.

Notes

A short note can be added here. It is not displayed outside the widget but can be set and retrieved with the WidgetID.Note property member.

Visible

Uncheck this box to hide the widget.

Fix
When the option “Fix” is checked, the InputBox will be displayed on every page.

Size

Enter a pixel size for the InputBox 's size.

X and Y

Enter the location of the widget (upper left corner) in pixels

Font
Edit the InputBox text font and the font size by clicking on the button with the current font.

To change the text color click in the small box on the right side.

Background Color
Click the box to open a color picker dialog for the background color.

Show On-Screen Keyboard on click

Check this box to open the integrated on-screen keyboard as soon as a click is performed inside the InputBox. This is especially useful for touch applications such as tablet PCs or touch monitors.

Is Password

This check box turns all entered characters to dot characters.

Read Only

Check this box to prevent the InputBox text from being changed manually. Changing the text per script is still possible.

Max.Length

Enter the maximum length of the entered character string. "0" stands for an infinite number of characters.

Execute script on Enter key

Enter a script that will be executed when the Enter key is pressed. Functions and Macros are a good option to manage large and sophisticated scripts.

Group Values

This option is only available for the Unlimited version and offers the possibility to assign a group. Please refer to the chapter Group Values for more information.

Ui Effects & Animations

CSS based effects and animations can be applied to this widget. Please refer to the topic Effects & Animations for more information.