Bar
Graphs
Bar graphs (class name:
obj_bargraph) are useful for comparing columns or rows of numeric data
from a tabular data element returned by your data attachment.
Using Data
and Data Label Properties
To attach data to your graph, right-click in the Property
Value field of the valueTable
property and select Attach to Data. It is possible to graph multiple columns or rows of numeric data.
If you include a label column in your data attachment for valueTable,
it can be used to label either the x-axis or the legend, depending on whether
the rowSeriesFlag is selected or deselected.
The
rowSeriesFlag
controls how row and column data populate the graph:
|
If the
rowSeriesFlag
checkbox is selected, one group of bars will be shown for each numeric
column in your data attachment. Within the group for each numeric column,
there will be a bar for each row in that column. Column names will
be used for the x-axis labels. If your data attachment has a label column
and the rowLabelVisFlag is selected, data from this column will
be used in the legend. If your data attachment does not have a label column,
select the
rowNameVisFlag
checkbox to use row names in the legend.
By default, the label column is the first non-numeric text column in your
data. Specify a column name in the labelColumnName property to set
the label column to a specific column. |
|
If the
rowSeriesFlag
checkbox is not selected, one group of bars will be shown for each row
in your data attachment. Within the group for each row, there will be a
bar for each column in that row. Column names will appear in the legend.
If your data attachment has a label column and the rowLabelVisFlag
is selected, data from this column will appear on the x-axis. If your data
attachment does not have a label column, select the rowNameVisFlag
checkbox to use row names on the x-axis. By default, the label column is
the first non-numeric text column in your data. Specify a column name in
the labelColumnName property to set the label column to a specific
column. |
To add one or more traces to your bar graph,
right-click in the Property Value field of the
traceValueTable
property and select Attach to Data. If you include a label column
in your data attachment for traceValueTable, this is used to label
either the x-axis or the legend (depending on the rowSeriesFlag)
if no label is available from the valueTable data attachment.
By default, the label column is the first non-numeric text column in your
data. Specify a column name in the traceLabelColumnName property
to set the label column to a specific column.
Using Interaction Properties
Commands
To assign a command to your graph, right-click in the Property
Value field of the command property and select Define Command.
Commands can be set up to
execute when you click on an object or
automatically execute the command when the value of an object reaches a
specified threshold.
See Building
Displays>Define/Execute Command for information on how to set up
commands. Drill Down Displays
To specify a drill
down display, double click on the drillDownTarget property. Any display (.rtv) file can be targeted as a drill down. Based on
your data attachment, substitutions are
created that will be passed into drill down displays. To customize which
substitutions will be passed into drill down displays, double-click
on drillDownColumnSubs in the
Object Properties window to open the Drill Down Column Substitutions dialog.
Once a drill down target has been set, double-click on the bar or trace
marker in the graph to activate the drill down. Drill down displays can
be activated in the same window that contains the graph or open in a separate
window. This allows you to build a customizable hierarchy of displays.
Use drillDownSelectMode to control
how a drill down display is activated. Set to Anywhere to activate
a drill down display by double-clicking anywhere on the graph. Set to Element
Only to enable a drill down display only when you double-click on a
bar in the graph.
Tool Tips
Select the mouseOverFlag
to enable tool tips for your bar graph. To display a tool tip, point to a bar or marker with your mouse. The tool tip will contain
information from your data attachment about that bar or marker. Select
the mouseOverHighlightFlag to enable bar highlighting.
Alert Properties
To set bar colors, trace
marker colors and trace marker styles based on a threshold value, select
the corresponding value alarm or value warning flags.
Property
Name |
Description |
traceValueAlarmStatusTable |
Attach an alarm table containing
status indexes to valueAlarmStatusTable to enable rule based alarm
statuses for trace markers. The table attached to valueAlarmStatusTable
must have the same number of rows and columns as traceValueTable.
For each data element in traceValueTable, the status index at the
corresponding position in valueAlarmStatusTable will be used to
set the alarm status of the marker.
Valid indexes are:
0 = use
normal marker color and style
1 = use low alarm marker color and style
2 = use low warning marker color and style
3 = use high warning marker
color and style
4 = use high alarm marker color and style
-1 = determine
marker color and style by comparing the value to the enabled alarm thresholds
If no data is attached to
valueAlarmStatusTable,
then the alarm status for a trace marker is determined by comparing the marker's
value to the enabled thresholds. |
valueHighAlarmEnabledFlag |
Select to enable the high
alarm threshold and the following related properties:
valueHighAlarm |
Set the value of the high alarm
threshold.
|
valueHighAlarmColor |
When a bar's value is greater
than or equal to the valueHighAlarm property, the color of the bar
will change to the valueHighAlarmColor.
|
valueHighAlarmLineVisFlag |
Select to display a dotted
line at the high alarm threshold. The color of the line is set to the valueHighAlarmMarkColor.
|
valueHighAlarmMarkColor/
valueHighAlarmMarkStyle |
When a trace marker's value
is greater than or equal to the valueHighAlarm property, the marker
will change to the valueHighAlarmMarkColor and valueHighAlarmMarkStyle. |
|
valueHighWarningEnabledFlag |
Select to enable the high
warning threshold and the following related properties:
valueHighWarning |
Set the value of the high warning
threshold.
|
valueHighWarningColor |
When a bar's value is greater
than or equal to the valueHighWarning, but less than the valueHighAlarm,
the color of the bar will change to the valueHighWarningColor.
|
valueHighWarningLineVisFlag |
Select to display a dotted
line at the high warning threshold. The color of the line is set to the
valueHighWarningMarkColor.
|
valueHighWarningMarkColor/
valueHighWarningMarkStyle |
When a trace marker's value
is greater than or equal to the valueHighWarning property but less
than the valueHighAlarm property, the marker will change to the
valueHighWarningMarkColor
and valueHighWarningMarkStyle. |
|
valueLowAlarmEnabledFlag |
Select to enable the low
alarm threshold and the following related properties:
valueLowAlarm |
Set the value of the low alarm
threshold.
|
valueLowAlarmColor |
When a bar's value is less
than or equal to the valueLowAlarm property, the color of the bar
will change to the valueLowAlarmColor.
|
valueLowAlarmLineVisFlag |
Select to display a dotted
line at the low alarm threshold. The color of the line is set to the valueLowAlarmMarkColor.
|
valueLowAlarmMarkColor/
valueLowAlarmMarkStyle |
When the trace marker's
value is less than or equal to the valueLowAlarm property, the marker
will change to the valueLowAlarmMarkColor and valueLowAlarmMarkStyle. |
|
valueLowWarningEnabledFlag |
Select to enable the low
warning threshold and the following related properties:
valueLowWarning |
Set the value of the low warning
threshold.
|
valueLowWarningColor |
When a bar's value is less
than the valueLowWarning property, but greater than the valueLowAlarm
property, the bar will change to the valueLowWarningColor.
|
valueLowWarningLineVisFlag |
Select to display a dotted
line at the low warning threshold. The color of the line is set to the
valueLowWarningMarkColor.
|
valueLowWarningMarkColor/
valueLowWarningMarkStyle |
When the trace marker's
value is less than or equal to the valueLowWarning property, but
greater than the
valueLowAlarm property, the marker will change
to the valueLowWarningMarkColor and valueLowWarningMarkStyle. |
|
Background Properties
Specify how the background
is displayed in your bar graph.
Bar Properties
Specify the way the bars
are displayed in your graph.
Property
Name |
Description |
barGradientStyle |
Select None, Shaded, or
Rounded
to set the gradient style of the bars. None is the default setting.
Select
Shaded to display bars with a flat gradient or
Rounded
to display bars with a rounded gradient. |
barImage |
Type the name of the image
to display in the bars or, select the
button to open the
Select Image dialog containing up to three
directories:
- Current Directory - Contains images in the current directory and one
level of subdirectories.
- Custom Image Library - If you have specified a custom image library, this
directory contains those images (.gif,
.jpg or .png). See
Creating a Custom Image Library for details.
- Symbol Library - Contains symbolic images (for example, symbols for
various types of hardware, shapes, lights, arrows, etc.).
Navigate to the image you want to use and select it. A preview of the image
appears in the pane to the right. Click OK or Apply to set the
image on your object. If
an image is not listed, enter the name of the file, including the relative path.
NOTE: If necessary, the image will be stretched to fit the bar size.
Creating a Custom
Image Library The custom image
library enables you to make your own images available in the Select Image
dialog. To add your own image library, perform the following steps.
1. Place your images .jar file and add
it to the RTV_USERPATH environment
variable. The images must be in a directory (not in the top level
of the jar). They can be organized into subdirectories of one top level
directory.
2. In the Display Builder, select Tools/Builder Options and, in the
Custom Image Library Path field, set the path to the directory containing
your images .jar file.
For example, if you have a jar with this directory
structure:
com/mycompany/Images
com/mycompany/Images/Blue Images
com/mycompany/Images/Red Images
com/mycompany/Images/Green Images
you would enter com/mycompany/Images. This adds a directory named
Images to the tree in the Select Image dialog. The Images directory
will have three subdirectories: Blue Images, Red Images and Green
Images. Only directories containing images are added to the Select Image
dialog.
To access the images, you can edit any property
that allows you to set an image on an object (for example, the image,
barImage and filterProperties properties), or edit the
File>Background Properties>Image Name
field. |
barProperties |
Double-click on barProperties
to open the Bar Properties dialog and specify the color and fill pattern to be used to display each bar in
the graph.
NOTE:
Fill Patterns set in the Bar Properties dialog will be ignored unless the
barGradientStyle property is set to None. |
barValueVisFlag
|
Select to
display a label containing the value for each bar. |
Column Properties
Specify which columns are
displayed in your bar graph.
Property
Name |
Description |
columnsToHide |
Specify columns from the
data attachment to exclude from being used for plotted data or labels.
Data from the labelColumnName column will be used for labels even
if that column name is also specified in the columnsToHide property.
Columns specified in the columnsToHide property can still be used
in the drillDownColumnSubs property. |
Data
Properties
Property
Name |
Description |
rowSeriesFlag |
Controls how row and column data populate the graph.
|
If rowSeriesFlag
is selected, one group of bars will be shown for each numeric
column in your data attachment. Within the group for each numeric column,
there will be a bar for each row in that column. Column names will
be used for the x-axis labels. If your data attachment has a label column
and the rowLabelVisFlag is selected, data from this column will
be used in the legend. If your data attachment does not have a label column,
select the
rowNameVisFlag
checkbox to use row names in the legend.
By default, the label column is the first non-numeric text column in your
data. Specify a column name in the labelColumnName property to set
the label column to a specific column. |
|
If rowSeriesFlag
is not selected, one group of bars will be shown for each row
in your data attachment. Within the group for each row, there will be a
bar for each column in that row. Column names will appear in the legend.
If your data attachment has a label column and the rowLabelVisFlag
is selected, data from this column will appear on the x-axis. If your data
attachment does not have a label column, select the rowNameVisFlag
checkbox to use row names on the x-axis. By default, the label column is
the first non-numeric text column in your data. Specify a column name in
the labelColumnName property to set the label column to a specific
column. |
|
traceValueDivisor |
Divides trace values by
the number entered. |
traceValueTable |
Attach your data to the
traceValueTable
property to add one or more traces to your bar graph. If you include a label
column in data attached to traceValueTable, it can be used to label
either the x-axis or the legend (depending on the rowSeriesFlag)
if no label is available from the valueTable data attachment.
NOTE: By default, the label column is the first non-numeric text column in your
data attachment. Enter a column name in the traceLabelColumnName property
to set a specific label column. |
traceYAxisValueMax
traceYAxisValueMin |
Select the traceYAxisFlag
to plot the traces against a separate y-axis than the bars. NOTE: The traceYAxisFlag
property is unavailable if the drawHorizontalFlag property is selected.
The trace y-axis will be drawn to the right of the plot area. When the
traceYAxisFlag
is
selected, the traceYAxisValueMin and traceYAxisValueMax properties
are used to control the range of the trace y-axis if yAxisAutoScaleMode
is set to Off or On-include Min/Max.
Select or enter the numeric
format of trace values displayed on the y-axis with the traceYAxisFormat
property.
To enter a format, use syntax from the Java DecimalFormat class. |
valueDivisor |
Divides bar and y-axis values
by the number entered. |
valueTable |
Attach your data to the valueTable
property. It is possible to graph multiple columns or rows of numeric data.
If you include a label column in data attached to valueTable,
it can be used to label either the x-axis or the legend, depending on whether
the rowSeriesFlag is selected or deselected.
NOTE: By default, the label column is the first
non-numeric text column in your data attachment. Enter a column name in the
labelColumnName property to set a specific label column. |
yValueMax
yValueMin |
Controls the range of y-axis if the yAxisAutoScaleMode is set to
Off.
Select
On for the yAxisAutoScaleMode to calculate the y-axis
range according to data values being plotted. To calculate the y-axis range
including
yValueMin and yValueMax, select
On - Include
Min/Max. |
Data Format Properties
Specify the data format
for your bar graph.
Property
Name |
Description |
labelColumnFormat |
Select or enter the format
of numeric or date labels displayed on the x-axis, in the legend and in tool
tips.
To enter a format, use syntax
from the Java DecimalFormat class for numeric labels and syntax from
the Java SimpleDateFormat class for date
labels. To enable tool tips, select the mouseOverFlag. |
traceYValueFormat |
Select or enter the numeric
format of bar values displayed in the legend and in tool tips.
To enter a format, use syntax
from the Java DecimalFormat class. To enable tool tips, select the mouseOverFlag. |
yValueFormat |
Select or enter the numeric
format of bar values displayed on bars, in the legend and in tool tips
To enter a format, use syntax
from the Java DecimalFormat class. To enable tool tips, select the mouseOverFlag. |
Data Label Properties
Property
Name |
Description |
columnDisplayNames |
Set alternate display
names for column names in your bar graph's data. Column names are displayed
either along the x-axis or in the legend, depending on whether or not rowSeriesFlag
is selected. |
labelColumnName |
Specify the name of a
label column in your data attachment. If a labelColumnName is not
specified, then by default the first non-numeric text column in your data
attachment will be used as the label column. |
rowLabelVisFlag |
If selected, then data
from the label column are displayed either along the x-axis or in the legend,
depending on whether or not rowSeriesFlag
is selected. Enter a column name in the labelColumnName property to
specify a label column in your data attachment. |
rowNameVisFlag |
If your data attachment
does not contain a label column (i.e. a non-numeric text column) select the
rowNameVisFlag
checkbox to use row names along the x-axis or in the legend, depending on
whether or not rowSeriesFlag
is selected. |
traceLabelColumnName |
Specify name of label
column in your data attachment. If a traceLabelColumnName is not
specified, then by default the first non-numeric text column in your data
attachment will be used as the label column. |
Historian Properties
Property
Name |
Description |
historyTableName |
Specify
name of table in your history database in which to store tabular data.
See
Configuring the Historian for information. |
historyTableRowNameFlag |
If
selected, data from the row name field will be stored in the first column of the
table specified in historyTableName. |
Interaction Properties
Property
Name |
Description |
command |
Assign a command to
your bar graph. 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. |
drillDownColumnSubs |
Select the
button to open the Drill Down
Column Substitutions dialog to customize which substitutions will be passed into
drill down displays. |
drillDownSelectMode |
Control how a drill
down display is activated. Select one of the following options:
Anywhere - Activate a drill down
display by double-clicking anywhere on the graph.
Element
Only - Enable a drill down display only when you double-click on a
bar in the graph.
|
drillDownTarget |
Name of display (.rtv)
file targeted as a drill down. See Building
Displays>Drill Down Displays for information. |
mouseOverFlag |
Select to enable tool tips for your bar graph. To
display a tool tip, point to a bar or marker with your
mouse. The tool tip will contain information from your data attachment about
that bar or marker. |
mouseOverHighlightFlag |
Select to enable bar highlighting. Once highlighting is enabled, point to
a bar with your mouse to highlight that bar.
|
scrollbarMode |
Select Never, As Needed,
or Always from the scrollbarMode property to set the behavior
of the x-axis scroll bar in the graph. NOTE: If drawHorizontalFlag
is selected, the x-axis is vertical. Never is the default setting.
If set to Never, some bars may get clipped. Select Always
to display a scroll bar at all times. Set to As Needed to display
the scroll bar when there is not enough space to display all of the bars
in the plot area. Each bar uses at least minSpacePerBar pixels along
the x-axis. |
scrollbarSize |
Specify the height of the
horizontal scroll bar and the width of the vertical scroll bar, in pixels.
The default value is -1, which sets the size to the system default. |
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.
This property is only applies if labelTextAlignY is
set to TabTop. |
labelTextAlignX |
Select x-axis position of label text from the
drop down menu. |
labelTextAlignY |
Select y-axis position of label text from the
drop down menu.
Outside Top
|
Position label well above the background rectangle. |
Top
|
Position label just above the background rectangle. |
Title Top |
Position label along the top line of the background rectangle. |
Tab Top |
Position label tab just above the background rectangle. Height and width of
the tab is dependent on the height and width of the text. Use the
labelMinTabWidth property to specify a minimum tab width. |
Inside Top |
Position label inside the top of the background rectangle. |
|
labelTextColor |
Select the
button and choose a color from the palette to set the label text color. |
labelTextFont |
Select font style of label text from the drop
down menu. |
labelTextHeight |
Set the height of the label text in pixels. |
Layout Properties
Specify how the background
is displayed in your bar graph.
Property
Name |
Description |
barCenterFlag |
Select to center the bars
in the plot area. If not selected, the bars will be left or top aligned,
depending on the drawHorizontalFlag. The barCenterFlag property is only
applicable if barFitFlag is not selected. |
barFitFlag |
Select to stretch the bars
to fit the available space in the plot area. If deselected, the minSpacePerBar
property
is used to determine bar width. |
draw3dDepth |
Specify width (in pixels) for the shadow of the
bars. |
draw3dFlag |
Select to change the display
of the bars from 2D to 3D. |
drawHorizontalFlag |
Select to have the bars
in your graph displayed horizontally. |
drawStackedFlag |
Select to stack each bar
group in your graph. |
drawWaterfallFlag |
Select to stack each bar
group in your graph with an offset between bar sections. |
horizAxisLabelRotationAngle
|
Set the amount of rotation of labels
on the horizontal axis. Values range from 0 to 90 degrees. A value of 0 causes
the bar graph to automatically pick the optimum angle of rotation. |
horizAxisMinLabelHeight
|
Set the minimum amount of space to
reserve for labels on the horizontal axis. If axis labels vary over time, this
property may be used to reserve a consistent amount of space to prevent
overlapping. |
minSpaceBetweenBars |
Set the minimum amount of space (in pixels)
between adjacent bars in the same group. |
minSpaceBetweenGroups |
Set the minimum amount of space (in pixels)
between the last bar in one group and the first bar in the next group. |
minSpacePerBar |
Set the minimum width (in pixels) for
each bar. Default is 1.
NOTE: If drawHorizontalFlag
is selected, minSpacePerBar will set the minimum height (in
pixels) for each bar. |
vertAxisMinLabelWidth |
Specify the minimum width
in pixels for the vertical axis labels. |
Legend Properties
Specify the way the legend
is displayed in your bar graph.
Property
Name |
Description |
legendBgColor |
Select the
button and choose a color from the palette to set the background color
of the legend. |
legendBgGradientColor2 |
Select the
button and choose a color for the second
color in the gradient. Default is white. NOTE: The legendBgColor property sets
the first color in the gradient. |
legendBgGradientMode |
Display a gradient
in the legend background. Select from the following options:
|
None |
No gradient |
|
Diagonal Edge |
Gradient is drawn
at a 45 degree angle from the top left to the bottom right corner of the
object. |
|
Diagonal Center |
Gradient is drawn
at a 45 degree angle from the center to the top left and the bottom right
corners of the object. |
|
Horizontal Edge |
Gradient is drawn
horizontally from the top to the bottom of the object. |
|
Horizontal Center |
Gradient is drawn
horizontally from the center to the top and bottom of the object. |
|
Vertical Edge |
Gradient is drawn
vertically from the left to the right of the object. |
|
Vertical Center |
Gradient is drawn
vertically from the center to the left and right of the object. |
|
legendValueVisFlag |
Select to display the numerical
values of your data in the legend. |
legendVisFlag |
Select to display the legend. |
legendWidthPercent |
Set the percent of the total
width of the object used for the legend. |
outlineColor |
Select the
button and choose a color from the palette to set the color of the
one-pixel outline around the legend area, around
each color swatch within the legend, around the plot area and each bar in the
graph. The default value is black (color 7). |
Marker Properties
Property
Name |
Description |
markDefaultSize |
Set to specify the size of the markers in pixels. |
markScaleMode |
Set
to
scale markers according to the order of the data in your data attachment. For
example, the marker for the first data in the attachment is the smallest and
the marker for the last data is the largest. Select one of the following options
from the drop down menu: No Scale, Scale
by Trace or Scale Within Trace.
|
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 |
Plot x-axis position of object. |
objY |
Plot y-axis position of object. |
styleClass |
Enter the style class name for this object as
defined in your style sheet.
If not specified, the object class name is used. NOTE: The value entered
must not contain spaces and cannot start with rtv-. |
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. |
Plot Area Properties
Property
Name |
Description |
gridBgColor |
Select the
button and choose a color from the palette to set the color of the grid
background. |
gridBgGradientColor2 |
Select the
button and choose a color for the second
color in the gradient. Default is white. NOTE: The gridBgColor property sets
the first color in the gradient. |
gridBgGradientMode |
Display a gradient
in the grid background. Select from the following options:
|
None |
No gradient |
|
Diagonal Edge |
Gradient is drawn
at a 45 degree angle from the top left to the bottom right corner of the
object. |
|
Diagonal Center |
Gradient is drawn
at a 45 degree angle from the center to the top left and the bottom right
corners of the object. |
|
Horizontal Edge |
Gradient is drawn
horizontally from the top to the bottom of the object. |
|
Horizontal Center |
Gradient is drawn
horizontally from the center to the top and bottom of the object. |
|
Vertical Edge |
Gradient is drawn
vertically from the left to the right of the object. |
|
Vertical Center |
Gradient is drawn
vertically from the center to the left and right of the object. |
|
gridBgImage |
Select an image to display
in the grid background of your graph. NOTE: If necessary, the image will
be stretched to fit the grid. |
gridColor |
Select the
button and choose a color from the palette to set the color of the grid lines.
Default is white. |
Trace Properties
Specify the appearance of plotting traces
in your bar graph.
See
Using Data
and Data Label Properties for information on how to add traces
to your bar graph.
Property
Name |
Description |
traceFillStyle |
Set traceFillStyle
to Solid, Transparent, Gradient, or Transparent
Gradient to fill the area under the trace. Set to None to disable
this feature. None is the default. |
traceProperties |
Specify the
line color, line style, line width, marker color and marker style of all
traces. |
traceShadowFlag |
Select to enable trace
shadows. |
X-Axis Properties
Specify how the x-axis is
displayed in your bar graph.
Property
Name |
Description |
xAxisFlag |
Select to display the x-axis. |
Y-Axis Properties
Specify how the y-axis is
displayed in your bar graph.
Property
Name |
Description |
traceYAxisFlag
|
Select the traceYAxisFlag
to plot the traces against a separate y-axis than the bars.
NOTE: The traceYAxisFlag
property is unavailable if the drawHorizontalFlag property is selected.
The trace y-axis will be drawn to the right of the plot area. When the
traceYAxisFlag
is
selected, the traceYAxisValueMin and traceYAxisValueMax properties
are used to control the range of the trace y-axis if yAxisAutoScaleMode
is set to Off or On-include Min/Max.
|
traceYAxisFormat |
Select or enter the numeric format of trace
values displayed on the y-axis.
To enter a format, use syntax from the Java DecimalFormat class. |
traceYAxisMajorDivisions |
Specify the number of major divisions on the
trace y-axis. This option only applies if the traceYAxisFlag is on. |
traceYAxisMinorDivisions |
Specify the number of minor divisions on the
trace y-axis. This option only applies if the traceYAxisFlag is on. |
yAxisAutoScaleMode |
The yValueMin and
yValueMax properties
control the range of y-axis if the yAxisAutoScaleMode is set to
Off.
Select
On for the yAxisAutoScaleMode to calculate the y-axis
range according to data values being plotted. To calculate the y-axis range
including
yValueMin and yValueMax, select
On - Include
Min/Max. |
yAxisFlag |
Select to display the y-axis. |
yAxisFormat |
Select or enter the numeric
format of values displayed on the y-axis.
To enter a format, use syntax
from the Java DecimalFormat class. |
yAxisGridMode
|
Controls the alignment
of grid lines drawn to the left and right of the bar graph.
By default, yAxisGridMode is set to Bar
Axis which aligns grid lines with the left y-axis. Select Trace Axis
to align with the right y-axis. Select Bar and Trace Axis to draw two
sets of grid lines, one aligned with the left y-axis and the other with the
right y-axis. |
yAxisMajorDivisions |
Specify the number of major
divisions on the y-axis. |
yAxisMinorDivisions |
Specify the number of minor
divisions on the y-axis. |
|