2 Visual Components Manuals

Max. Text Length
Rows
Font
Possible Settings for Full
Graphic Displays
Possible Settings for Text
and Semi−Graphic
Displays
The field can be placed freely in the display. Therefore, Y can
be set from 0 to the height of the display minus the height of the
field in pixels.
On text and semi−graphic displays, such as those which can be
connected to the C130 CAN controller, fields can only be placed
evenly on every eighth Y−coordinate (Y = 0, 8, 16, 24, etc.).
Specifies the maximum number of characters which can be displayed in a ListBox line. Texts
longer than the allowed length will be truncated; blank spaces are used to "fill in" shorter
texts.
Possible Settings The field must be able to fit in the picture with its set size and
font.
Specifies the number of rows that will be displayed in the ListBox which also becomes the
height of the output field.
Possible Settings The field must be able to fit in the picture with its set size and
font.
Chooses the output field font.
Possible Settings Any font in the project can be selected.
Source of Texts
Determines the source of the displayed texts. Only one of the two following options can be selected and used.
Text Group
String
Array
Assign...
With this setting, a text group is used as the source for the text to be displayed. The text cannot be
altered during runtime, but language switching can naturally be used.
Possible Settings Text group with default text numbering (text groups with text numbering which
has been changed by the user cannot be used).
With this setting, an array of STRINGs is used as the source for the text. In this way, texts can be
changed and expanded during runtime. However, language−switching must also be prepared in the
application if it is to be used.
Possible Settings Name of a process variable of data type STRING[][].
Example:
In ANSI C, the variable must be declared as follows to define and connect 4
texts with a maximum length of 80 characters to the ListBox.
_GLOBAL plcstring texts[4][80];
Access is then possible with normal array indexing, with texts[0] designating
the first string and texts[1][4] designating the fifth character in the second
string.
Possible Values The strings can contain any desired text, but only characters existing in the
selected font will be displayed on the screen.
The Assign... button opens a dialog box to select a variable for the String array input field. By
default, only variables of suitable types are displayed.
It should be noted that the entire array is connected, not just parts of it.
Variables
Introduction to Visual Components 2.3
Allows the connection of the variable which should select the text highlighted in the output field. In this way,
texts in the ListBox are automatically advanced and the marked text is visible. The ListBox is an output field,
which means that the operator cannot change the variable using the ListBox itself. However, this can be solved
with additional input elements in the application.
102 3.2.3.6 ListBox Output Field − Reference