This function block is used to refer to a button in an HMI, which can be labeled with a text.

The input bShow is used to show or hide the HMI object. It is enabled with a HIGH signal on the input bEnable and disabled with a LOW signal. The inputs iLang, iText and sText are used to label the button. A language specific text resource (see mask designer) is selected with iLang and iText. The plain text that is connected to sText is displayed if iText is not connected or the parameter value “undefined” is assigned to it.

After pressing the button, the output bPress changes from LOW to HIGH for one program cycle.

HMI object

The HMI object displays a button with a black textual label, which is centered horizontally and vertically.


In the parameter dialog an HMI object of the type “Button (unicode)” is assigned to the function block.

By using the context menu of the function block, the mask designer can be invoked as the parameter dialog. The mask designer is used to create the assignment to the HMI object. Now the preferences of the HMI object can be set with the help of the mask designer.

The font and the default values for the label and the activation state are set in the parameter dialog of the object. A language specific text resource or a plain text can be assigned to label it.


Name I/O Type(s) Function
sText I TEXT, DYNTEXT Plain text
iText I WORD Text resource (ID)
bShow I BIT Show/hide object
bEnable I BIT Enable/disable
iLang I WORD Language resource (ID)
bPress O BIT Button pressed

Note: If inputs are not connected, the object appears with the corresponding default parameters that have been entered in the mask designer. Otherwise the input signal from the function block overwrites the according setting from the parameter dialog.


The colored highlight in the function block indicates, whether an HMI object is assigned or not.