A pie-bar graph is a graph in which data is represented as slices of a pie or ring, and the data that one of the pie slices shows is represented in more detail by a percentage bar that is connected to the slice. Each slice represents a total; the markers in the percentage bar represent the values that make up the total shown in one of the slices.
Pie-bar graphs are useful in showing the relationship of parts to the whole, while showing more detail for one of the parts.
For example, the pie or ring might show which product line accounts for the highest percentage of sales, and the bar might show the sales in that product line for each of the different districts.
The following varieties of pie-bar graphs are available:
PIE_BAR
-- The center of the pie is full.
RING_BAR
-- The center of the pie has a hole, in which the total pie value is
displayed.
The following properties of the Graph
object affect pie-bar graphs:
PieBarSeries
-- Specifies the series for which the bar shows detail.
DepthRadius
and DepthAngle
-- Together, these
properties specify whether the graph appears to have depth.
The following figure shows the data structure of a pie-bar graph.
The data structure of a pie-bar graph is as follows:
A group is represented by the pie or ring and by one marker in the stack of bars. Note that the pie or ring is a calculated group; no column or row of data corresponds to it. No group label appears in the graph.
A series is represented by one slice of each color in the pie or ring and, for one series, by the entire stack of bars. Series are labeled by legend text, such as Audio Div.
Pie-bar graph data has the following guidelines:
Graphs display numeric data only.
Pie-bar graphs cannot have negative numbers. If you pass negative numbers
to a pie-bar graph, then the graph sends an AlertEvent
to any
AlertListeners
that have been registered. The ID of the alert
event is either DATA_ALL_DATA_NULL_NEG_ZERO
or DATA_PARTIAL_DATA_NULL_NEG_ZERO
.
Pie-bar graphs should have at least two groups of data.
Pie-bar graphs should have at least two series of data.
By default, the graph displays detail for the first series of data. To
specify a different series for which you want detail, set the PieBarSeries
property of the graph.
This example shows pie-bar data.
This example shows the same data in a grid. This example assumes that Graph.isDataRowShownAsASeries
returns true
.
![]() |
Australia | Asia | Americas | Europe |
---|---|---|---|---|
Audio Div | 409726 | 861868 | 1495079 | 1968312 |
Video Div | 307062 | 702414 | 1022541 | 1642478 |
Accessory | 23600 | 71239 | 102493 | 162783 |
Handling Problems
in Graph Data
Specifying Data for a Graph
Example: Setting JDBC Data on
a Simple Graph
Example: Setting Data from a
File on a Simple Graph