Visualization Element ‘Combo box – Integer’

Symbol:

Tag: Common controls

This element lists values in a drop-down list. The index of the selected value is written to a variable. The element entries can be from a list and contain images from an image pool.

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 integer

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

Variable	Variable (integer data type). The value of the variable determines the index of the selected list element.
Text list	Text list that determines the selection in the drop-down list. Example: TextList_A. The IDs of the selected text list must be in the value range of DWORD or DINT. This also applies to element variables of type “enumeration” with text list support. Please note: If a text list is not defined, then you must type a minimum value and maximum value in the Value range property. As an alternative to the text list, a Variable of type “Enumeration with text list support” can be used.
Image pool	Collection of images for the drop-down list of the element. Example: ImagePool_A.

Element property ‘List settings’

Displayed list that expands when a visualization user clicks into the element.

Row height	From style: The values are used that are defined in the assigned visualization style. Direct entry of a numeric value.
Number visible rows	Restricts the number of rows in the drop-down list. From style Direct entry of a numeric value.
The images from an image pool can be displayed in the rows of the drop-down list. Requirement: An existing image pool is selected in the Image pool property. Parts of the image are clipped that are outside the drop-down list.
Image height	From style Direct entry of a numeric value (in pixels).
Image width	From style Direct entry of a numeric value (in pixels).
Image offset	The value defines the horizontal position of the image within the row (in pixels). The value 0 corresponds to the left edge of the drop-down list. From style Direct entry of a numeric value.
Scrollbar size	Width of the scrollbar. The scrollbar is displayed when more entries are specified in the drop-down list than in Number visible rows. Default: 20.

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 ‘Value range’

Value range limit	: Minimum and maximum values of the text list are used as limits. Requirement: The Text list property is associated to a text list.
Minimum value	Lower limit of the output value fixed value
Maximum value	Upper limit of the output value fixed value
Filter missing text entries	: Only existing texts in the text list are displayed. Unused IDs are filtered out.

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.
Horizontal alignment	Horizontal alignment of the text within the element.
Vertical alignment	Vertical alignment of the text within the element.
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.

Element property ‘Access rights’

Requirement: User management is set up for the visualization.

Access rights

Opens the Access rights dialog box for changing the access rights for the element. Status messages: Not set. All rights.: Access rights for all user groups : operable Rights are assigned: limited rights: Access is restricted for at least one group.

See also

• Dialog Box ‘Access rights’

See also

• Designing Visualizations with Elements