Pie
Graphs
The pie graph (class name:
obj_pie) is useful for comparing values from a single column or a single
row of the tabular data element returned by your data attachment.
Data and Data Label Properties
Attach your data to the valueTable
property.
If you include a label column in your data attachment for valueTable,
it can be used to label the legend if the rowSeriesFlag is selected.
The
rowSeriesFlag controls whether row or column data populates
the graph:
|
When the
rowSeriesFlag
checkbox
is not selected, the first numeric column from your data attachment will
be used to populate the wedges in the pie. Each wedge will correspond to
a row in that column and will display that row's relative value. If your
data attachment has a label column, data from that column will be used
in the legend. |
|
If the
rowSeriesFlag
checkbox is selected, the first numeric row from your data attachment will
be used to populate the wedges in the pie. Each wedge will correspond to
a column in that row and will display that column's relative value. Column
names will be used in the legend. |
If your data attachment has
no label column, select
rowNameVisFlag to use row names in the legend
when the rowSeriesFlag is not selected. 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.
Column Properties
Specify which columns are
displayed in your pie 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 Format Properties
Specify the format to display
values in your pie graph.
| Property
Name |
Description |
| labelColumnFormat |
Select or enter the format
of numeric or date labels displayed in the legend and in tooltips.
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 tooltips, select the mouseOverFlag. |
| valueFormat |
Select or enter the numeric
format of wedge values displayed on wedges, in the legend and in tooltips.
To enter a format, use syntax
from the Java DecimalFormat class. To enable tooltips, select the mouseOverFlag. |
Background Properties
Specify how the background
is displayed in your pie graph.
| Property
Name |
Description |
| bg3dFlag |
Select to display a 3D edge on the
background rectangle. |
| bgColor |
Select the 
button and choose a color from the palette to set the background color. |
| bgEdgeWidth |
Set the width of the 3D
edge on the background rectangle. This property is only used if the bg3dFlag
is selected. |
| bgGradientFlag |
Select to display a gradient
in the background rectangle. |
| bgVisFlag |
Select to display the background
rectangle. |
Wedge Properties
Specify the way wedges are displayed in your pie graph.
| Property
Name |
Description |
| wedgeProperties |
Specify the color of wedges in the pie
graph. |
| wedgeGradientFlag
|
Select the box to enable the gradient
effect. NOTE: All wedges in the pie are affected by the wedgeGradientFlag
property. |
Legend Properties
Specify the way the legend
is displayed in your pie graph.
| Property
Name |
Description |
| legendBgColor |
Select the
button and choose a background color for the legend. |
| legendBgGradientFlag |
Select the legendBgGradientFlag
to display a gradient in the legend background. |
| legendPercentVisFlag |
Select to display the value
percentages of your data in the legend. |
| 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. |
Interaction Properties
To specify a drill
down display, double click on the drillDownTarget Property
Name. 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 pie wedge 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
wedge in the pie graph.
Select the mouseOverFlag
to enable tooltips for your pie graph. To display a tooltip, select the
graph and point to a pie wedge with your mouse. The tooltip will contain
information from your data attachment about that pie wedge.
|
