TextBox

Navigation:  Widget Designer > Widgets >

TextBox

Previous page Return to chapter overview Next page

The TextBox widget allows you to add an editable text to remote control text assets within Pandoras Box via the Textbox Input Node and the PB Text Output Node.

wd_widget_text-box

To create a TextBox widget choose "Widgets > TextBox". 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.

To edit the TextBox 's font and color, first switch to the edit / move mode ([F9]) and then right-click on the desired TextBox 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 TextBox property dialog opens up.

wd_widget_text-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 TextBox ’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 TextBox will be displayed on every page.

Size

Enter a pixel size for the TextBox 's size.

X and Y

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

Font
Edit the TextBox 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 TextBox. This is especially useful for touch applications such as tablet PCs or touch monitors.

Max.Length

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

Title

Enter here a title that is displayed at the top of the TextBox. Uncheck the box "Show Title" if you want to remove the title bar.

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.

 

To link the TextBox to a Text asset in Pandoras Box, please use a Text Box Input Node and connect it to a PB Text output node.

To change the text of a TextBox e.g. via a Custom Script Button, these commands are available:

Dynamic script setup

With the following commands you can use a TextBox to hold and collect script snippets that could be executed at any given time:
WDTextboxAppend(ID,Value)
WDTextboxNewline(ID)
WDTextboxExecuteAsScript(ID)

Imagine you want to build a signal router remote application.
You can use buttons to set the source selection and buttons to append the script code for the target selections. A take button would use the entire script that is inside the TextBox and executes it as one big dynamically created script.
This way it is much easier to create and react to certain conditions and logics that would require many more nodes to be set up.