PtBarGraph
![[Previous]](prev.gif) |
![[Contents]](contents.gif) |
![[Index]](keyword_index.gif) |
![[Next]](next.gif) |
PtBarGraph
A bar graph
Class hierarchy:
PtWidget → PtBasic → PtBarGraph
For more information, see the diagram of the widget hierarchy.
PhAB icon:
Public header:
<photon/PtBarGraph.h>
Description:
PtBarGraph draws a horizontal or vertical bar graph, with or without a grid.
A PtBarGraph widget.
You specify the bars by setting Pt_ARG_BARGRAPH_DATA to an array of values. The colors of the bars depends on how you set the widget's resources:
- To specify the color for each bar, set Pt_ARG_BARGRAPH_COLOR to be an array of PgColor_t values.
- If you set Pt_ARG_BARGRAPH_COLOR to NULL, the widget uses the value of Pt_ARG_COLOR for all the bars.
The Pt_ARG_BARGRAPH_FLAGS resource controls the direction of the graph and whether or not the grid is displayed.
If you set Pt_ARG_BARGRAPH_DEPTH to a positive value, the bars are drawn with a bevel.
New resources:
| Resource | C type | Pt type | Default |
|---|---|---|---|
| Pt_ARG_BARGRAPH_BASE | short | Scalar | 0 |
| Pt_ARG_BARGRAPH_COLOR | PgColor_t, short | Array | NULL |
| Pt_ARG_BARGRAPH_DATA | short, short | Array | NULL |
| Pt_ARG_BARGRAPH_DEPTH | short | Scalar | 0 |
| Pt_ARG_BARGRAPH_FLAGS | long | Flag | Pt_BARGRAPH_VERTICAL |
| Pt_ARG_BARGRAPH_GRID_COLOR | PgColor_t | Scalar | Pg_DGREY |
| Pt_ARG_BARGRAPH_GRID_HORIZ | short | Scalar | 6 |
| Pt_ARG_BARGRAPH_GRID_VERT | short | Scalar | 6 |
| Pt_ARG_BARGRAPH_MAX | short | Scalar | SHRT_MAX |
| Pt_ARG_BARGRAPH_MIN | short | Scalar | SHRT_MIN |
Pt_ARG_BARGRAPH_BASE
| C type | Pt type | Default |
|---|---|---|
| short | Scalar | 0 |
The value that's used as the base line for the bars. If the data for a bar is greater than this value, the bar is displayed above the base line (for a vertical bar graph) or to the right (for a horizontal graph).
Pt_ARG_BARGRAPH_COLOR
| C type | Pt type | Default |
|---|---|---|
| PgColor_t, short | Array | NULL |
An array of colors to use for the bars. If this resource is NULL, the widget uses the value of Pt_ARG_COLOR (inherited from PtBasic) as the color for all the bars.
You should have at least as many bar colors as entries in the Pt_ARG_BARGRAPH_DATA array.
 |
You can't edit this resource in PhAB. |
Here's an example of setting this resource:
PgColor_t bar_colours[7] = {Pg_RED, Pg_BLUE, Pg_CELIDON,
Pg_GREEN, Pg_YELLOW, Pg_MAGENTA,
Pg_DGREEN };
PtSetResource (widget, Pt_ARG_BARGRAPH_COLOR, bar_colours, 7);
Pt_ARG_BARGRAPH_DATA
| C type | Pt type | Default |
|---|---|---|
| short, short | Array | NULL |
The data to be displayed in the bar graph. When you set this resource, the value is the array of data, and arg is the number of bars.
|
You can't edit this resource in PhAB. |
Here's an example of setting this resource:
short bar_values[7] = {0, 450, 399, 22, 500, 50, 555 };
PtSetResource (widget, Pt_ARG_BARGRAPH_DATA, bar_values, 7);
Pt_ARG_BARGRAPH_DEPTH
| C type | Pt type | Default |
|---|---|---|
| short | Scalar | 0 |
The depth of the bars in the graph, in pixels.
Pt_ARG_BARGRAPH_FLAGS
| C type | Pt type | Default |
|---|---|---|
| long | Flag | Pt_BARGRAPH_VERTICAL |
Flags that affect the appearance and behavior of the bar graph; a combination of:
- Pt_BARGRAPH_GRID
- Display a grid.
- Pt_BARGRAPH_VERTICAL
- Make the bars vertical.
- Pt_BARGRAPH_HORIZONTAL
- Make the bars horizontal.
Pt_ARG_BARGRAPH_GRID_COLOR
| C type | Pt type | Default |
|---|---|---|
| PgColor_t | Scalar | Pg_DGREY |
The color of the grid, if displayed.
|
You can't edit this resource in PhAB. |
Pt_ARG_BARGRAPH_GRID_HORIZ
| C type | Pt type | Default |
|---|---|---|
| short | Scalar | 6 |
The number of horizontal lines in the grid.
Pt_ARG_BARGRAPH_GRID_VERT
| C type | Pt type | Default |
|---|---|---|
| short | Scalar | 6 |
The number of vertical lines in the grid.
Pt_ARG_BARGRAPH_MAX
| C type | Pt type | Default |
|---|---|---|
| short | Scalar | SHRT_MAX |
The maximum value in the bar graph.
Pt_ARG_BARGRAPH_MIN
| C type | Pt type | Default |
|---|---|---|
| short | Scalar | SHRT_MIN |
The minimum value in the bar graph.
Inherited resources:
If the widget modifies an inherited resource, the “Default override” column indicates the new value. This modification affects any subclasses of the widget.
|
|
|
|
