A text block where the user can enter text and that can be used in a project.

Input Field

Polybench reference manual · Last updated 2026-06-18

The Input Field can be used to let the end-user enter text in an application. The text that is entered is stored in a Variable of the Input Field, and can be read by other objects in the application. Also, the entered value can be put out using an Action.

The Input Field is either single line, or allows the end-user to enter multiple lines.

Properties

Find more information about changing properties here: "Properties Viewer"

Action

type: Select from the list
Select the code of the Action that is performed when you press enter of when you leave the input field.

Select one of those presets:

Value

type: See description [this value cannot be changed]
The value to set at the Address is determined automatically

Address

type: Address, enclosed in '$' characters (see "Address - how to address objects and variable parameters")
Fill in the address of the object that should receive the Action.

You may type or paste the address, or you may press the small button on the right to open the Address Constructor ("Address Constructor")

MultipleLines

type: True or False
Set to True if the input field should display more than one line.

Select one of those presets:
True or False
True may also be read like 'yes' and false like 'no'

TextLength

type: Integer value
the maximal length of the input text. The length is not checked if this value is set to -1.

ReadOnly

type: True or False
Set to True if the input field should not allow textual input.

Select one of those presets:
True or False
True may also be read like 'yes' and false like 'no'

Per default the Input Field is not for reading only, because its main purpose is to provide textual input. However, the Input Field can also be used to just display text and in that case ReadOnly property should be True.

PasswordText

type: True or False
Set to True if the input field should hide the text by showing blinding characters only.

Select one of those presets:
True or False
True may also be read like 'yes' and false like 'no'

SelectOnFocus

type: True or False
Set to True if the input field should select its contents if the user gives it the focus for the first time.

Select one of those presets:
True or False
True may also be read like 'yes' and false like 'no'

Action when focus is lost

type: True or False
Set to True if the specified action is to be performed as soon as the input field looses focus of the cursor. By default this is True.

Select one of those presets:
True or False
True may also be read like 'yes' and false like 'no'

This feature was added in Polybench 1.34.1. In older versions the behaviour is as if this flag is True.

BackgroundColor

type: Known color name
The background color of the text box

This property uses the Color Repository. For more information about the use of colors in a project, refer to "Color Repository"

TextColor

type: Known color name
The text color

This property uses the Color Repository. For more information about the use of colors in a project, refer to "Color Repository"

BlinkColor

type: Known color name
The alternate color of the background if the input field is in blinking mode.

This property uses the Color Repository. For more information about the use of colors in a project, refer to "Color Repository"

Font

type: Known text font name
The font of the text

This property uses the Font Repository. For more information about the use of text fonts in a project, refer to "Font Repository"

Size

type: Size containing width and height
The size of the user interface of this object (width, height).

Coordinates

type: Coordinate
The location of the user interface of this object in (x,y) coordinates, relative to the object it is on top of.

Caption

type: Word or phrase
The name of the object in the project. This name must not contain '.', '$' nor '@' characters.

For more information about the rules and usage of the Caption property, please refer to "Caption property - background and usage".

Documentation

type: See description
Optional documentation of this object. If this object is an operator, the Documentation text is displayed below the operator symbol.

Variable Parameters

Find more information about Variable Parameters here: "Variable Parameters"

Address

type: See description
The address of the variable that is linked to the input field, using the specified Action.

Please note that if you are using SET_PARAMETER in another object to change this address, that in the other object's Value property you need to use a double '$' sign to copy the address. Otherwise you would copy the contents of the address, in stead of the address itself.

Text

type: See description
The text that is currently displayed in the input field

If you set a new text using a SET_PARAMETER action in another component, then the text that is displayed will change. This will however not induce the action that is specified in the properties of the Input Field!

Functions

Find more information about Functions here: "Operator Functions"

Blink

Starts blinking the input field background, using the BlinkColor

BlinkOff

Lets blinking the input field background stop

Enable

Sets the input field to Enabled, so that it accepts user input.

Disable

Sets the input field to Disabled, so that it does not accept any user input.

Focus

Sets the cursor or focus on this Input Field

The Input Field can be used either passively or actively. In passive mode, no Action is selected (Action is 'None'). If the user types text into the box, then nothing happens. Other components in your project may read the text, but the Input Field doesn't care about that.

In active mode, an Action has been specified. You may select any available Action, but in most cases you would probably select SET_PARAMETER. With SET_PARAMETER you can change a text or value in another component in your project. If you use this feature, then after typing text and either pressing Enter, or optionally when leaving the Input Field, the new text is copied to the specified address (see Address property). Also, in this case the text or value of that address is always displayed in the Input Field.

In some cases it is useful that the text inside the Input Field is selected as soon as the end-user clicks on it for the first time. The end-user can then delete the contents by starting to type. To enable this feature, the SelectOnFocus property should be set to True (default True).

To draw the attention of the end-user, you may call the Blink function, using a FUNCTION action. After calling the Blink function, the Input Field starts blinking, using the Blink Color, until the end-user clicks on the Input Field.

Since Polybench 1.34 it is also possible to direct the focus on an Input Field actively, by calling its Focus function.

If a general RESET action is called, then the contents of the Input Field are removed. This only happens if the Input Field is in passive mode.

One application to demonstrate the behavior of the Input Field, is to add an Input Field to a project, and also a Variable Viewer ("Variable Viewer"). Let the Address of the Variable Viewer point to the address of the 'Text' variable of the Input Field. If you now type text in the Input Field, the text will be copied to the Variable Viewer immediately, as shown in the following figure:

If the Input Field is placed on a Printable Page, it will not be printed on paper.