Legend dialog
- Last UpdatedOct 29, 2026
- 3 minute read
Access the dialog
To access the Legend dialog for a specific Trend Control screen object, first access the Object Properties dialog for that screen object and then click Legend.
The dialog in detail

The Legend dialog contains the following elements:
-
Show: When checked, the embedded legend is displayed during runtime. This interface provides useful information associated with the pens currently linked to the object.
-
Available / Visible: The items in the Visible box are displayed in the legend during runtime. You can add items to and remove them from the Visible box using the » and « buttons respectively. Moreover, you can use the Move Up and Move Down buttons to change the order in which the items are displayed in the legend during runtime.
The following table lists the available legend items:
Item
Legend Icon
Description
Eng Units
The tag/pen's Engineering Units.
Min
The tag/pen's minimum possible value.
Max
The tag/pen's maximum possible value.
Selection

Press button to select another tag for this pen.
Remove

Press button to completely remove this pen from the legend and the Trend chart.
Hide

Select (check) option to hide this pen in the Trend chart.
Pen Style

Press button to change the pen's line style, weight, color, markers, and so on.
Scale

Select (check) option to show the pen's scale on the Trend chart.
Description
Description of the tag/pen.
Current
The current value of the tag configured to the pen.
Cursor
The value of the pen where it intersects the cursor line.
-
Properties: Allows you to configure the properties for the field highlighted in the Available or Visible box:
Property
Description
Label
Label for the field displayed during runtime
Width
Width for the field (in pixels) during runtime.
Align
Alignment of the data displayed in the field.
Available during runtime
When this option is checked, the user can show or hide the field during runtime.
-
Maximum size: Defines the size of the legend in terms of number of rows. For instance, the user might have 8 points being displayed in the trend object, if the maximum size is set to two, the legend will have a scroll bar to allow the user to scroll to the other points.
-
Number of items: Number of points (default) displayed on the legend. You can allow the user to add/remove points during runtime regardless of the value in this field.
-
Selected Item: You can configure a numeric tag in this field. The object writes in this tag the number of the selected row. In addition, you can select different rows by writing their values in this tag.
-
Fonts: Sets the font for the text displayed in the legend.
For more information, see About the trend control runtime interface.