Widget Properties
The outlooking, behavior, location and size of widgets are called properties. The properties could be set in
property sheet in editing mode, and also can be changed in the attached scripts during run mode. 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:
-
lower case of all characters
-
eplace space to underscore.
For Example: The property_id of "Foreground Color" is "foreground_color".
Common Properties for most widgets
The common properties (PropertyName(Property_id)) for most of the widgets:
-
Basic
-
Name(name). The name of the widget.
-
Widget Type(widget_type). The type of the widget. This is the only property that is uneditable. 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 controllable.
-
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).
-
Foreground Color(foreground_color).
-
Tooltip(tooltip). Tooltip of the widget. Macros are allowed and can be updated. 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
Common Properties for PV widgets
For the widget which has the property of "PV Name(pv_name)", "Readback PV(pv_name)" or "Control PV(control_pv)", we
call it PV Widget. During runtime, right click a PV widget and then you will see the "CSS" context menu which allows
it connecting with other CSS Applications. The PV name is the bridge of the connection.
The common properties for most of the PV widgets:
- PV Name(pv_name). The name of the main PV associated with the widget.
- Readback PV(pv_name). Same as PV Name.
- Control PV(control_pv). The name of the PV to be controlled.
- Limits From PV(limits_from_pv). Load the Maximum, Minimum, HIHI, HI, LOLO, LO limits from PV.
- Border Alarm Sensitive(border_alarm_sensitive). The border color and style will change to alarm border and color when PV is in alarm state.
- ForeColor Alarm Sensitive(forecolor_alarm_sensitive).
- BackColor Alarm Sensitive(backcolor_alarm_sensitive).
There is also an invisible property: pv_value, which is the value of the PV.