The button (frame) display element creates a button which launches another user interface screen if pressed. The screen to be launched may be another user defined screen or a predefined one.
The attributes listed below may be configured to customize a display element of this type:
Label: The label text is drawn on the button.
Privilege level: The privilege level necessary to change this parameter. The predefined screens of the software use 100. In your own screens you may set certain parameters to higher privilege levels, limiting the group of operators permitted to change the parameter.
Use icon instead of label: Check this checkbox in order to make the button show an icon instead of a label text.
Icon: Provides a list of all available icons / images on the sat-nms server.
Font: Font contains two options:
- 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.
- 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 using a hexadecimal RGB notation. You may click to the color example field in order to open a color chooser dialog and select the color from there.
Button action: with this field you select the function of the button. The available functions are listed below. The meaning of the parameters right beside the function selector changes with the function selected.
- BROWSER-VIEW: Launches the platform's standard web browser and shows the given URL. URL must be entered.
- CHILD-SCREEN: Launches a new screen in a separate window. Screen name must be entered.
- FREC-VIEW: Launches a graphical presentation screen for data recorded with a File-Recorder logical device. MNC.device name must be provided (e.g. ANT-11.REC-SYS).
- LOAD-PRESET: Launches a dialog to select and apply a preset to a given device. MNC.device name must be provided (e.g. ANT-11.REC-SYS). You can also set driver and search pattern. Search pattern field with this value. Only presets containing the pattern string (character case doesn't matter) will appear in the list.
- REPLACE-SCREEN: Replaces the actual screen by another one, re-uses the same window.
- SPECTR-VIEW: Launches the device window of a spectrum analyzer and optionally sets an arbitrary number of parameters. MNC.device name must be provided (e.g. ANT-11.REC-SYS). An optional macro list. This may contain zero or more parameter ID - value pairs. These settings may be used to preset the spectrum analyzer certain settings but also to control switches or other devices in the signal path. Example: S03=B, SA1.center=12345.666 If the operator clicks to this button, the switch S03 is commanded to position B, the spectrum analyzer SA1 is set for a center frequency of 12345.666 MHz and the spectrum analyzer window gets opened.
- TRACK-VIEW: Launches a tracking report window for the Antenna-Tracking logical device. The tracking report window shows azimuth or elevation together with the beacon level over the recent 48 hours. MNC name and ACU driver must be provided. Typically this is the "state.mode4" Parameter of an Antenna-Tracking or a SatService-ACU-ODM device.
- TREE-NAVIGATE: This button used to navigate to tree devices as user screen. Tree path must be MNC.Subsystem (e.g. ANT-11.GATES)
Conditionally enable widget: Parameter fields may be locked to read only state unless another parameter matches a given value. For instance, changing the position of a wave guide switch may be inhibited while the carrier is switched on. Check this to activate this feature.
- Enable ID: This field defines the ID for the enabling parameter.
- Enable value: The value belonging to the parameter above. The actual value of the parameter
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. 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.
- Color: The color specification of the actually selected table entry. Clicking to this opens a color chooser dialog which lets you select/compose the the color to your needs.
- Value: The parameter value of the actually selected table entry.
- Bold: Draws the text bold if the parameter value matches.
- Add: To add a new value / color pair to the list, fill the value and color fields.
- Set: To change the color assigned to a given parameter value, first select the table entry of interest, change the color value.
- Delete: To delete a value / color pair from the list, first select the table entry then click delete.