Polybench® Reference
On-screen keyboard, of which the key layout can be edited

Key Pad

Overview

This is a keyboard objects that has been designed to be used on touch-screen monitors. The lay-out of the key pad can be changed by specifying a matrix of characters that make out the keys.

Properties

Find more information about changing properties here: link

BackgroundColor
type: Known color name
The background color of the key pad. Select a color from the color repository.

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

ForegroundColor
type: Known color name
The foreground color of the key pad. Select a color from the color repository.

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

Font
type: Known text font name
The font of the characters on the keys. Choose a font from the font repository.

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

ChangeLayout
type: Select from the list
Select one of the preset key layouts, to change the layout.
Select one of those presets:
NoChange
Key layout not changed.
Numerical
Standards numerical key pad layout.
FullInternational
Full keyboard, international layout.


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 '.' or '$' characters.

Every object has the Caption property. This property is very important, because it is the name by which Polybench recognizes this object.
It is allowed to give multiple objects the same name, as long as the objects are of the same type. In that case, a reference to this caption includes all the objects with the same caption.
In Polybench, every object can be addressed by an Address specifier, which starts with the dollar sign, for example: $My Page.My Object. 'My Page' would be the Caption of a page, and 'My Object' the Caption of an object on that page.

Documentation
type: See description
Optional documentation of this object.

It is good practice to write in short notes why you have used this object, and why its properties are set the way they are set. If this object is an operator, the Documentation text is displayed below the operator symbol.

Functions

Find more information about Functions here: link

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

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

Details

Note: This object is not yet fully implemented. You cannot define your own key matrix yet - in stead you can choose between a standard numerical key pad, or an international full-keyboard.