Visualization Element ‘Combo box Array’

Symbol:

Tag: Common controls

This element lists rows with values in a drop-down list. The index of the selected row is written to a variable.

Element properties

Element name	Optional Tip: Assign individual names for elements so that they are found faster in the element list. Example: List_Product_Number.
Element type	Combo box array

Element property ‘Position’

The position defines the location and size of the element in the visualization window. These are based on the Cartesian coordinate system. The origin is located at the upper left corner of the window. The positive horizontal x-axis runs to the right. The positive vertical y-axis runs downwards.

X	X coordinate of the upper left corner of the element Specified in pixels. Example: 10.
Y	Y coordinate of the upper left corner of the element Specified in pixels. Example: 10.
Width	Specified in pixels. Example: 150
Height	Specified in pixels. Example: 30

Note

You can also change the values by dragging the box symbols ( ) to other positions in the editor.

See also

• Positioning Elements, Adapting Size and Layer

Element property ‘Columns’

The “Combo box – Array” element visualizes an array variable or structure variable in a tabular view. The index of array elements or structure components is shown in a column or row. Two-dimensional arrays or structure arrays are shown in several columns. You specify the visualized variable in the Data array property. If a variable is assigned there, then you can specify the display of the table columns where the array elements are shown. You can customize each column that is assigned to an index [<n>].

Columns [<n>]	Due to the structure of the variable that is defined in Data array, CODESYS determines the number of columns and defines them with the index <n>. Example: StringTable : ARRAY [0..2, 0..4] OF STRING := ['BMW','Audi','Mercedes','VW','Fiat', '150','150','150','150','100','blue','gray','silver','blue','red'];: three columns are formed [0], [1] und [2].
Max. array index	Optional. Variable (integer data type) or value. Defines up to which array index the data is displayed.
Row height	Height of the rows (in pixels).
Number visible rows	Optional. If the array is larger than the number of visible rows, then a scrollbar is included.
Scrollbar size	Width of the vertical scrollbar (in pixels).

Element property ‘Columns: Column [<n>]’

Width	Column width (in pixels).
Image column	: Images can be displayed in the column. Images are used from the global image pool or user-defined image pools. The image IDs are shown in the cells of the table as defined in the image pool.
Image configuration
Fill mode	Fill cell: The image resizes to the dimensions of the cell without fixing the height/width ratio. Centered: The image is centered in the cell and it retains its proportions (height-width ratio).
Transparency	: The color that is specified in Transparent color is displayed as transparent.
Transparent color	This color is displayed as transparent. Requirement: The Transparency property is selected.
Text alignment in column	Left Centered Right

Element property ‘Texts’

Tooltip

Character string (without single straight quotation marks) that is displayed as the tooltip of an element in runtime mode. Example: Number of valid accesses. CODESYS accepts the specified text automatically into the GlobalTextList text list. Therefore, the texts can be localized.

See also

• Designing Visualizations with Elements

Element property ‘Text properties’

The properties contain fixed values for the text properties.

Usage of	Default style values: The values of the visualization style are used. Individual settings: The “Individual text properties” property group is shown The values can be customized here.
Individual text properties Requirement: The Individual settings text property is defined.
Font	Example: Default : The Font dialog box opens. : Drop-down list with style fonts.
Font color	Example: Black : The Color dialog box opens. : Drop-down list with style colors.
Transparency	Whole number (value range from 0 to 255). This determines the transparency of the respective color. Example: 255: The color is opaque. 0: The color is completely transparent. Please note: If the color is a style color and already has a transparency value, then this property is write-protected.

Element property ‘State variables’

The variables control the element behavior dynamically.

Invisible	Variable (BOOL). Toggles the visibility of the element. TRUE: The element is not visible at runtime.
Deactivate inputs	Variable (BOOL). Toggles the operability of the element. TRUE: User inputs do not have any effect in runtime more. The element is shown as deactivated.