This function block is used to refer to a text displayed in an HMI.

The object is displayed with a HIGH signal on the input bShow and hidden with a LOW signal. The inputs iLang, iText and sText are used to label the object. 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. lFGClr and lBGClr define the foreground and background colors.

Here you can find an example about how to display formatted digits on a screen.

HMI object

The HMI object displays a text, which is either given as a plain text or as a text resource.


In the parameter dialog an HMI object of the type “Text (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 colors are set in the parameter dialog of the object. A language specific text resource or a plain text can be assigned to it. Furthermore the alignment of the text can be adjusted.


Name I/O Type(s) Function
sText I TEXT, DYNTEXT Plain text
iText I WORD Text resource (ID)
bShow O BIT Show/hide object
iLang I WORD Language resource (ID)
lBGClr I LONG Background color
lFGClr I LONG Text color

Note: If the 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.