## Widget Properties

The outlooking, behavior, location and size of widgets are called properties. Properties can be set in property sheet in editing mode, and could also be changed in attached rules or scripts in Runtime. The value of the any property can be accessed with Property Macro via property_id.

In most cases, the property_id is following this convention corresponding to the property name:

1. lower case of all characters
2. replace space with underscore.

For Example: The property_id of "Foreground Color" is "foreground_color".

### Properties Common to All Widgets

Few properties may be hidden for some particular widgets on purpose. Property id is shown in braces, which can be used to access the property in Rules or Scripts.

- Basic
  - Name(name). The name of the widget.
  - Widget Type(widget_type). The type of the widget. This property that is not editable. The name and type of the selected widget will also be displayed on the status bar.
- Behavior
  - Actions(actions). The actions assocaited with the widget.
  - Enabled(enabled). A disabled control widget is not operatable.
  - Rules(rules). The rules attached to the widget.
  - Scripts(scripts). The scripts attached to the widget.
  - Visible(visible). Visibility of the widget.
- Border
  - Border Color(border_color). The color of the border.
  - Border Style(border_style). The style of the border.
  - Border width(border_width). The width of the border. Only meaningful for line or dot line styles.
- Display
  - Background Color(background_color). Color of Background.
  - Foreground Color(foreground_color). Color of foreground. In most cases, it is the font color too.
  - Tooltip(tooltip). Tooltip of the widget. Macros are allowed and can be updated when tooltip is shown again. The property macro $(pv_value) could be used to show the PV value which has timestamp, value, severity and status.
- Position
  - Height(height). The height of the widget in pixels.
  - Width(width). The width of the widget in pixels.
  - X(x). X location coordinate in pixels. The zero point of the coordinate system is on the left-top cornor. Negative coordinate is allowed, but is not recommended.
  - Y(y). Y location coordinate in pixels
  - Scale Options (scale_options). The options to control the scale behavior of the widget.