The DisplayElement is used to display M&C parameters read-only. It looks much alike the ParameterElement element, but never allows to change the parameter it displays.
Data Model (extends ScreenElement)
| Key | Type | Value |
|---|---|---|
| type | String | Always "DisplayElement". |
| xpos | Number | see ScreenElement |
| ypos | Number | see ScreenElement |
| width | Number | see ScreenElement |
| height | Number | see ScreenElement |
| id | String | The message ID this element listens to |
| label | String | A label shown above the field / drop down |
| enableId | String | The enable ID (may be empty) |
| enableValue | String | The value which must be matched to enable the field |
| font | String | The font to be used |
| color | String | The color used for the label (#RRGGBB) |
| drawFrameless | Boolean | true = display without a frame and with transparent background |
| variableBackgroundColor | Boolean | true = use a variable background color. |
| colorId | String | The message ID to listen for the background color |
| colors | Array | of ColorDefinition objects. Defines how to translate values of the colorId parameter to color values. |
Remarks
Conditionally Enable: If the enableId property is not empty, the ParameterElement subscribes for this additional parameter and disables (disabled means "dimmed" in this case) the widget unless the received parameter value matches the values stated in enableValue.
Font Selection: The sat-nms software defines 6 preset fonts named 'small', 'plain', 'bold', 'title', 'huge' and 'typewriter'. The font property contains one of these names. The selected font is used for the text in the widget, the label above the entry field always is shown with the 'plain' font, unless font reads 'small', in this case the label is shown with the 'small' font as well. For information about fonts and font sizes see section Fonts in the appendix of this document.
Variable Background Color: With the variableBackgroundColor parameter set 'true', the DisplayElement listens to the additional parameter stated in colorId and sets the background color of the widget according to the value received. The received value is translated to a color (and optional 'bold' printing) through the colors array. If the received value does not match any of the values listed in the array, the first entry in the array is used as a default / fallback.