RelatedDisplayNode

A widget representing a menu of other UI screens that can be opened by a user.

These other screens are detailed by the attribute links which is a list of dictionaries. Within each dictionary, the following values can be defined:

  • label - The display name for the screen to open
  • file - The filepath for the screen to open
  • macros - Any macros to pass the screen when opening
  • replace - Optional, Whether to replace the parent screen when opening, False by default


  • Special Attributes
Name Type Description
geometry Rect A rectangle describing the position and dimensions of the widget
text String The widget’s display text
foreground Color Widget foreground color
background Color Widget background color
font Font Widget display font
links List A list of dictionaries describing the linked UI screens
visibility String A pv that determines the visibility of the widget, visibility is turned off if the PV’s value is zero. This logic is inverted if the !Not tag is used instead of String
  • Example
- !RelatedDisplay
    foreground: *black
    background: *edit_blue

    text: "Open xxx"

    geometry: 10x200 x 100x20

    links:
        - { label: "File 1", file: "xxx.ui", macros: "P=1,R=A" }