Creating a picture of the type Keyboard

A keyboard picture is created by defining a new picture of the type Keyboard. You will find more information on the pre-defined picture types in the chapter 'Pictures / Pre-defined picture types'.

After the picture is opened an empty picture is displayed. The default control elements can be inserted with the entry Control elements in the pulldown menu.

The control elements consist of the keys of a standard keyboard.

The following reserved picture names exist for pictures of the picture type Keyboard and can be selected from the listbox Picture name:

Name	Description
DIALOGKBD	if there is a picture with this name, it will be opened in the Runtime every time a dialog is loaded, e.g. for entering a new recipe name in the RGM.
SETBOOLKBD	if there is a picture with this name, it will be opened in the Runtime every time an input for binary variables is required.
SETSTRINGKBD	if there is a picture with this name, it will be used in the Runtime instead of the standard dialogbox for string variables.
SETVALUEKBD	if a picture with this name exists, it will be used in Runtime instead of the standard dialogbox for numerical variables.

Define position

You can define a preferred position and also an alternative position for the automatic keyboard.
You define these positions with 4 values:

top/bottom
right/left
vertical distance
horizontal distance

If there is not enough space for the keyboard at the preferred position, it will be displayed at the alternative position. If there is also not enough space there, the position will be defined by the system.

Properties for positioning the automatic keyboard:

Property	Description
Alignment vertical	With 'top' (default) or 'bottom' you position the keyboard above or below the element.
Alignment horizontal	'Left' (default) positions the left corner of the keyboard in relation to the top or bottom left corner of the element. 'Right' positions the right corner of the keyboard in relation to the top or bottom right corner of the element.
Vertical movement in pixels	Distance of the corners to each other in pixels. Positive values move the keyboard upwards, negative values move it downwards.
Horizontal movement in pixels	Distance of the corners to each other in pixels. Positive values move the keyboard to the right, negative values move it to the left.

RGM specific

Under Control elements -> RGM specific you can find the following elements which are available for the Keyboard in the recipe group manager:

Element	Description
Button OK, send	The set value is written to the variable directly after the keyboard is closed.
Button OK, save	The recipe concerned is saved directly after the keyboard is closed.
Button OK, send, save	The set value is written to the variable directly after the keyboard is closed and after that the recipe concerned is saved.

Info

When creating a picture of picture type Keyboard that is used as a set-value-box, the control element Set value element has to be inserted.

Attention

If a picture of the type 'Keyboard' is not opened as a modal dialog, but in full screen mode, it may happen that the menus (see Menu administration) are hidden. This can be avoided e.g. with a function Close template, with which the keyboard template is closed.