3.16.2.4.2 Read-Only Parameter

The Read-Only Parameter display element is used to display M&C parameters read-only. It looks much alike the Parameter element, but never allows to change the parameter it displays.

The attributes listed below may be configured to customize a display element of this type:

• message ID --- The message ID addresses the parameter the element shall display or edit. The message ID consists of the device name followed by a colon and the name of the parameter. XMIT-1.tx.on for example addresses the variable tx.on at a device named XMIT-1 . With the ' Device Driver Index ' in the appendix of this document there is a list of variable names provided for each device driver the software supports.
• color --- The color attribute of a parameter element sets the color of the label shown above the entry field. The text in the parameter field itself always is shown in the default text color of the selected look & feel. Colors may be specified by standard color names like red / green / blue or using a hexadecimal RGB notation. '#FFFF00' for example specifies yellow. You may click to the color example field in order to open a color chooser dialog and select the color from there.
• font --- The font attribute applies to the text shown in the parameter field itself. The label text is shown with the standard ("plain") font size for all font selections except the smallest one. In the latter case the label is drawn using this small font size, too.
• draw frameless with transparent background --- Check this mark to let the software draw the element without a entry field frame and with transparent background. With this option the Read-Only-Parameter element can be used as a label which changes it's text with the value of a variable. Please note that you cannot use the 'variable background color' option (described below) together with the frameless / transparent background option.
• use variable background color --- Checking this mark enables the variable background color feature for this screen element. Depending on the actual value of the variable addressed by 'color id', the element's background is set using the translation table shown in the lower left corner of the dialog. If the actual value of the color id variable does not match any of the table entries or if no color id is specified, the first color in the list is used to draw the element's background.The buttons Add/Set/Delete along with the value and color fields are used to edit the color translation table.
• color id --- The message ID of the parameter which controls the background color of this element.
• value --- The parameter value of the actually selected table entry
• color --- The color specification of the actually selected table entry. This may either be the name of a basic color (red, yellow etc.) or a hexadecimal RGB color specification like '#FF8000'. The latter defines some sort of orange, consisting of 0xFF red, 0x80 green and 0x00 blue. The actually selected color is shown in the right part of the entry field, clicking to this opens a color chooser dialog which lets you select / compose the the color to your needs.
• Add / Set / Delete --- These buttons control editing the color translation list.
  • To add a new value / color pair to the list, fill the value and color fields, then click to "Add".
  • To change the color assigned to a given parameter value, first select the table entry of interest, change the color value and finally click "Set".
  • To delete a value / color pair from the list, select the table entry and then click "Delete".

Remarks

• The predefined screens of the software always use the "plain" font and a height of 21 pixels for parameter fields.