Text Input Buttons
Text Input Buttons provide a method for the user to enter text on the panel.
Creating Text Input Buttons
- Open the Page, Popup Page or Sub-Page that the button will be added to (double-click on the page in the Workspace window (Pages tab) to open the page and bring it into edit focus).
- Select the Button Draw tool from the Button Selection/Draw toolbar.
- Click on a Page, Popup Page or Sub-Page (in the active Design View window), and while holding the mouse button down, drag to draw the button to the desired size and shape.
Upon the creation of a button, you will see selection handles appear on the outsides of the button that are small yellow squares with red interiors. This is a visual indication that the newly created button has the Edit Focus.
- In the General tab of the Properties window, set the Type property to Text Input.
This selection updates the Properties window to represent properties specific to this button type.
- Set the button properties as desired by editing the General, Programming and States properties in the Properties window.
- Select File > Save to save your changes.
Text Input Buttons - General Properties
Once you have created a Text Input button, you can use the General tab of the Properties window to set/edit general (non-state oriented) button properties. To edit any of the properties in the table, click on an item in the right-hand column to activate the field. Depending on the item selected, you can either set the item manually, select from a drop-down menu, or both. The following General button properties are supported for Text Input buttons:
| Text Input Buttons - General Properties |
|---|
Type
| see
page 247
| | |
Name
| see
page 242
| | |
Lock Button Name
| see
page 242
| | |
Description
| see
page 236
| | |
Left
| see
page 238
| | |
Top
| see
page 246
| | |
Width
| see
page 247
| | |
Height
| see
page 237
| | |
Touch Style
| see
page 247
| | |
Border Style
| see
page 236
| | |
Disabled
| see
page 236
| | |
Hidden
| see
page 237
| | |
Input Type
| see
page 238
| | |
Password Character
| see
page 242
| | |
Display Type
| see
page 236
| | |
Max Text Length
| see
page 242
| | |
Input Mask
| see
page 238
|
Text Input Buttons - Programming Properties
Once you have created a Text Input button, you can use the Programming tab of the Properties window to set/edit programming- oriented button properties. To edit any of the properties, click in the right-hand table cell to activate the field. Depending on the item selected, you can either set the item manually, select from a drop-down menu, or both. The following Programming properties are supported for Text Input buttons:
| Text Input Buttons - Programming Properties |
|---|
Address Port
| see
page 247
| | |
Address Code
| see
page 249
| | |
Channel Port
| see
page 249
| | |
Channel Code
| see
page 249
|
Text Input Buttons - States Properties
Once you have created a Text Input button, you can use the States tab of the Properties window to set/edit state-oriented button properties. To edit any of the listed button properties, click on an item in the right-hand column to activate the field. Depending on the item selected, you can either set the item manually, select from a drop-down menu, or both.
The State tab of the Properties window works in conjunction with the State Manager window. Note that if the State Manager is not displayed, or if no state(s) are selected in the State Manager, the States tab shows a list of all states associated with the selected button. Each state represented in the States tab is a collapsed folder containing the state properties for that particular state. Click the + symbol to expand each folder. If you select a state (or multiple states) in the State Manager, then the States tab only represents the selected state(s).
The following button state properties are supported for Text Input buttons (for each state):
| Text Input Buttons - States Properties |
|---|
Border Name
| see
page 252
| | |
Border Color
| see
page 251
| | |
Fill Type
| see
page 252
| | |
Fill Color
| see
page 252
| | |
Fill Gradient Colors
| see
page 252
| | |
Gradient Radius
| see
page 253
| | |
Gradient Center X%
| see
page 253
| | |
Gradient Center Y%
| see
page 253
| | |
Text Color
| see
page 254
| | |
Text Effect Color
| see
page 254
| | |
Overall Opacity
| see
page 253
| | |
Bitmaps
| see
page 251
| | |
Font
| see
page 252
| | |
Font Size
| see
page 253
| | |
Text
| see
page 254
| | |
Text Effect
| see
page 254
|
NOTE: Text Input buttons do not support Events.