Vu Scales
Alert Properties
Property
Name |
Description |
thresholdColorBarFlag |
If
selected, the portion of the bar that exceeds a threshold will be painted in
the threshold color. This property is only used if either the
valueHighAlarmEnabledFlag or the valueHighWarningEnabledFlag is selected. |
thresholdLineVisFlag |
Select to draw thresholds behind the active bar
in paler versions of the threshold colors. |
valueHighAlarmEnabledFlag |
Select to enable the high
alarm range and the following related properties:
valueHighAlarm |
Specify the minimum value for
the high alarm range.
|
valueHighAlarmColor |
Specify the color for the high alarm range. |
|
valueHighWarningEnabledFlag |
Select to enable
the high warning range and the following related properties:
valueHighWarning |
Specify the minimum value for
the high warning range.
|
valueHighWarningColor |
Specify the color for the high warning range. |
|
|
Axis Properties
Property
Name |
Description |
axisColor |
Select the
button and choose from the palette to set
the color of the axis line and tick marks. |
axisDirection |
Select the direction of the axis:
- Bottom to Top - Vertical axis with valueMin at the bottom and valueMax at the top.
- Left to Right - Horizontal axis with valueMin at the left and valueMax at the right.
- Top to Bottom - Vertical axis with valueMax at the bottom and valueMin at the top.
- Right to Left - Horizontal axis with valueMin at the right and valueMax at the left
|
axisMinLabelWidth |
Specify the
minimum width (in pixels) for the axis labels. |
axisFormat |
Select
or enter the numeric format of values displayed on the axis. NOTE: To enter a
format, use syntax from the Java DecimalFormat class. |
axisLineThickness |
Select
Thin, Medium or Thick to
specify the thickness of the axis line and tick marks. NOTE: This property
only applies if the specified axisStyle is any of the Classic
styles or Ticks and
Labels. |
axisMajorDivisions |
Specify
the number of major divisions on the axis. |
axisMinorDivisions |
Specify
the number of minor divisions on the axis. |
axisOnTopOrRightFlag |
If
selected, a horizontal axis will be positioned above the scale or a vertical axis
will be positioned to the right of the scale. |
axisStyle |
Select
the axis style from the drop down menu:
- Classic with
Labels - Classic style axis with an axis line,
tick marks and labels at the major divisions.
- Classic without Labels - Classic
style axis with an axis line and tick marks but without labels.
- Classic with End Labels - Classic
style axis with an axis line and tick mark. Maximum and minimum value labels
will be positioned at the ends of the scale.
- Ticks
and Labels - Axis with only tick marks and
labels.
- Bar with Labels - Axis with labels at the major divisions.
- Bar without Labels - Bar style axis
without labels.
- Bar with End Labels - Bar style axis with maximum and minimum value labels at
the ends of the scale.
- Labels Only - Show labels at the major divisions, but show no axis lines
or tick marks.
- End Labels Only - Show minimum and maximum value labels at the ends of the
scale.
|
axisTextColor |
Select the
button and choose from the palette to set
the color of the axis labels. |
axisTextFont |
Select
a font to use the for the axis labels. |
axisTextHeight |
Specify
a size for the axis labels. |
axisVisFlag |
Control visibility of the axis. |
centerMinMaxAxisLabelsFlag |
If selected, minimum and maximum value labels are
centered on the axis tick marks. If not selected, these axis labels will be justified so they don't extend past the
end of the axis. NOTE: This property only applies if the specified axisStyle
displays labels next to tick marks. |
Background Properties
Bar Properties
Property
Name |
Description |
barBgColor |
Select the
button and choose from the palette to set
the color of the bar background. NOTE: This property only used applies if barBgOpaqueFlag is selected. |
barBgOpaqueFlag |
If
selected, the bar background is filled in. Otherwise, it is transparent. |
barBorderColor |
Select the
button and choose from the palette to set
the color of the border of the bar. NOTE: This property only applies if barBgBorderFlag is selected. |
barBorderFlag |
If
selected, a border is displayed around the bar. |
barColor |
Select the
button and choose from the palette to set
the color of the bar. |
barInsets |
Specify
the insets (in pixels) between the edge of the bar and the bar lines. |
Data Properties
Property
Name |
Description |
value |
Attach your data. |
valueDivisor |
If
specified, this divisor is applied to the value, valueMin and valueMax. |
valueMax |
Set
the maximum range for the scale. This value must be larger than valueMin. |
valueMin |
Set
the minimum range for the scale. This value must be smaller than valueMax. |
Data Format Properties
Property
Name |
Description |
valueFormat |
Select
or enter the numeric format of value displayed in the value label. To enter a
format, use syntax from the Java DecimalFormat class. |
valueTextColor |
Select the
button and choose from the palette to set
the color of the value label. |
valueTextFont |
Select
the font to use for the value label. |
valueTextHeight |
Specify
the height for the value label. |
valueTextPosition |
Set
the position of value label. Select from the following options:
- Outside Max - Position outside
the maximum value.
- Inside Max - Position inside the maximum value.
- Outside Current - Position
outside the current value.
- Inside Current - Position inside the current value.
- Center - Position at the center
of the scale.
- Inside Min - Position inside the minimum value.
- Outside Min - Position outside
the minimum value.
|
valueVisFlag |
Control visibility of the value label. |
Interaction Properties
Property
Name |
Description |
command |
Assign a command to
your vu scale. See Building
Displays>Define/Execute Command for information. |
commandCloseWindowOnSuccess |
If selected, the
window that initiates a system command will automatically close when the system
command is executed successfully. This
property only applies to system commands.
With data source commands, the window is closed
whether or not the command is executed successfully.
For multiple commands, this property is applied
to each command individually. Therefore if the first command in the multiple
command sequence succeeds, the window will close before the rest of the commands
are executed.
NOTE: The commandCloseWindowOnSuccess
property is not supported in the Display Server. |
commandConfirm |
If selected, the
command confirmation dialog is enabled. Use the commandConfirmText
property to write your own text for the confirmation dialog, otherwise text from
the command property will be used. For
multiple commands, if you Confirm the execution then all individual commands
will be executed in sequence with no further confirmation. If the you Cancel the
execution, none of the commands in the sequence will executed. |
commandConfirmText |
Enter command
confirmation text directly in the Property Value field or select the
button to open the Edit commandConfirmText dialog. If
commandConfirmText is not specified, then
text from the command property will be used. |
drillDownTarget |
Name of display (.rtv)
file targeted as a drill down. See Building
Displays>Drill Down Displays for information.
When you double-click on a trace in the scale,
the following predefined substitutions will be set on the specified
drillDownTarget:
- $traceNumber - number of the trace (1 to 10)
that contains the selected point
- $traceLabel - label of selected trace
- $pointValue - data value of point
- $pointTimestamp - timestamp of point
- $pointLabel - data label (if any) of point
- $pointIndex - position of point in trace data
(0 to maxPointsPerTrace)
NOTE: When drillDownSelectMode is set to
Anywhere double-clicking anywhere on the scale will activate the
specified drillDownTarget, however you must double-click on a trace in
the scale to set the substitutions listed above. |
mouseOverText |
Enter a tool tip for
this scale. To
display the tool tip, move your mouse over the object. To enter a multi-line
tool tip, use \n to delimit the lines (e.g. my\nscale). NOTE: The object
must be visible (i.e. visFlag property is selected), in order for the
tool tip to be visible. |
Label Properties
Property
Name |
Description |
label |
Edit label text directly in the Property Value
field or select the
button to open the Edit Label dialog. |
labelMinTabWidth |
Specify minimum width of the label tab. NOTE:
This property is only applies if labelTextPosY is
set to TabTop. |
labelTextColor |
Select the
button and choose from the palette to set the color of the label text. |
labelTextFont |
Select the font style of the label text from drop
down menu. |
labelTextHeight |
Set the height (in pixels) of the label text. |
labelTextPosX |
Set
x-axis position of label text. Select from the following options:
- Left - Position outside the left
side of the background rectangle.
- Inside Left - Position inside the left side of the background
rectangle.
- Center
-
Position in the center of the background rectangle.
- Inside Right - Position inside the
right side of the background rectangle.
- Right - Position outside the right side of the background
rectangle.
|
labelTextPosY |
Set
y-axis position of label text. Select from the following options:
- Outside Top - Position well above the background rectangle.
- Top -
Position just above the background rectangle.
- Title Top - Position along the top
line of the background rectangle.
- Tab Top - Position tab just above the background rectangle. NOTE: Height
and width of the label tab is dependent on the height and width of the text. Use
the labelMinTabWidth property to specify a minimum tab width.
- Inside Top - Position inside the top
of the background rectangle.
- Center - Position in the center of the background rectangle.
- Inside Bottom - Position inside the
bottom of the background rectangle.
- Bottom - Position just below the background rectangle.
- Outside Bottom
- Position well below
the background rectangle.
|
labelVisFlag |
Control visibility of the label. |
Object Properties
Property
Name |
Description |
anchor |
Specify where to
anchor an object in the display. NOTE: If an object has the dock property
set, the anchor property will be ignored.
The anchor property is only applied when the
dimensions of the display are modified, either by editing
Background Properties or resizing the window in
Layout mode
Select None, or one or more the following
options:
None
|
Object
not anchored. This is the default. |
Top |
Anchor
top of object at top of display. |
Left |
Anchor
left side of object at left of display. |
Bottom |
Anchor
bottom of object at bottom of display. |
Right |
Anchor
right side of object at right of display. |
When a display is resized, the number of pixels
between an anchored object and the specified location remain constant. If an
object is anchored on opposite sides (i.e. Top and Bottom or
Left and Right), the object will be stretched to fill the available
space. |
dock |
Specify the docking
location of an object in the display.
Select from the following options:
None
|
Object
is not docked. This is the default. |
Top |
Dock
object at top of display. |
Left |
Dock
object at left of display. |
Bottom |
Dock
object at bottom of display. |
Right |
Dock
object at right of display. |
Fill |
Dock
object in available space remaining in the display after all docked objects
are positioned. |
If the dimensions of the display are modified,
either by editing Background Properties or
resizing the window in Layout mode, the
properties (objX, objY, objWidth and objHeight) of
docked objects will automatically adapt to match the new size of the display.
When multiple objects are docked to the same side
of the display, the first object is docked against the side of the display, the
next object is docked against the edge of the first object, and so on.
When objects are docked to multiple sides of the
display, the order in which objects were added to the display controls docking
position. For example, let's say the first object added to the display is docked
at the Top and the second object is docked at the Left.
Consequently, the first object will fill the entire width of the display and the
second object will fill the left side of the display from the bottom of the
first object to the bottom of the display.
Objects in a display have the dock property set
to Fill, are laid out across a grid in the available space remaining
after all docked objects are positioned. By default, the grid has one row and as
many columns as there are objects in the display. You can modify the grid in the
Background Properties dialog.
Once an object is docked, there are some
limitations on how that object can be modified.
- Docked objects cannot be dragged or
repositioned using objX and objY properties.
- Docked objects cannot be resized using the
objWidth or objHeight properties. To resize you must drag on the
resize handle.
- Docked objects can only be resized toward the
center of the display (e.g. If an object is docked at the Top, only its
height can be increased by dragging down toward the center of the display).
- Docked objects set to Fill cannot be
resized at all.
- Docked objects cannot be moved using Align.
Non-docked objects can be aligned against a docked object, but a docked object
will not move to align against another object.
- Docked objects are ignored by Distribute.
|
objHeight |
Set height of the object in pixels. |
objName |
Name given to facilitate object management via
the Object List dialog. Select Tools>Object List. |
objWidth |
Set width of the object in pixels. |
objX |
Set the x position of the object. |
objY |
Set the y position of the object. |
transparencyPercent |
Set transparency of the object. Enter a value
between 0 and 100. A value of 0, the default, sets the object to be completely
opaque. A value of 100 will render the object completely transparent. |
visFlag |
Control visibility of the object. |
|