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:

Pt_ARG_BARGRAPH_BASE

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

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

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

The depth of the bars in the graph, in pixels.

Pt_ARG_BARGRAPH_FLAGS

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

The color of the grid, if displayed.

---

You can't edit this resource in PhAB.

---

Pt_ARG_BARGRAPH_GRID_HORIZ

The number of horizontal lines in the grid.

Pt_ARG_BARGRAPH_GRID_VERT

The number of vertical lines in the grid.

Pt_ARG_BARGRAPH_MAX

The maximum value in the bar graph.

Pt_ARG_BARGRAPH_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.