#include <Wt/Chart/WCartesianChart>
Public Member Functions | |
WCartesianChart (WContainerWidget *parent=0) | |
Create a new cartesian chart. | |
WCartesianChart (ChartType type, WContainerWidget *parent=0) | |
Create a new cartesian chart. | |
void | setType (ChartType type) |
Change the chart type. | |
ChartType | type () const |
Returns the chart type. | |
void | setOrientation (Orientation orientation) |
Change the chart orientation. | |
Orientation | orientation () const |
Returns the chart orientation. | |
void | setXSeriesColumn (int modelColumn) |
Change the the model column for the X series. | |
int | XSeriesColumn () const |
Returns the model column for the X series. | |
void | addSeries (const WDataSeries &series) |
Add a data series. | |
void | removeSeries (int modelColumn) |
Remove a data series. | |
void | setSeries (const std::vector< WDataSeries > &series) |
Change all data series. | |
WDataSeries & | series (int modelColumn) |
Returns a data series corresponding to a data column. | |
const WDataSeries & | series (int modelColumn) const |
Returns a data series corresponding to a data column. | |
const std::vector< WDataSeries > & | series () const |
Returns a list with the current data series. | |
WAxis & | axis (Axis axis) |
Access a chart axis. | |
const WAxis & | axis (Axis axis) const |
Access a chart axis. | |
void | setBarMargin (double margin) |
Change the margin between bars of different series. | |
double | barMargin () const |
Returns the margin between bars of different series. | |
void | setLegendEnabled (bool enabled) |
Enable the legend. | |
bool | isLegendEnabled () const |
Returns whether the legend is enabled. | |
virtual void | paint (WPainter &painter, const WRectF &rectangle=WRectF()) const |
Paint the chart in a rectangle of the given painter. | |
virtual void | drawMarker (const WDataSeries &series, WPainterPath &result) const |
Draws the marker for a given data series. | |
virtual void | renderLegendItem (WPainter &painter, const WPointF &pos, const WDataSeries &series) const |
Renders the legend item for a given data series. | |
Protected Member Functions | |
void | paintEvent (WPaintDevice *paintDevice) |
Paint the widget. | |
virtual WChart2DRenderer * | createRenderer (WPainter &painter, const WRectF &rectangle) const |
Create a renderer which renders the chart. | |
Private Member Functions | |
virtual void | modelColumnsInserted (const WModelIndex &parent, int start, int end) |
Method called when colums have been inserted in the model. | |
virtual void | modelColumnsRemoved (const WModelIndex &parent, int start, int end) |
Method called when colums have been removed from the model. | |
virtual void | modelRowsInserted (const WModelIndex &parent, int start, int end) |
Method called when rows have been inserted from the model. | |
virtual void | modelRowsRemoved (const WModelIndex &parent, int start, int end) |
Method called when rows have been removed from the model. | |
virtual void | modelDataChanged (const WModelIndex &topLeft, const WModelIndex &bottomRight) |
Method called when data has been changed in the model. |
A cartesian chart is a chart that uses X and Y axes. It can display one or multiple data series, which each may be rendered using bars, lines, areas, or points.
To use a cartesian chart, the minimum you need to do is set a model using setModel(), set the model column that holds the X data using setXSeriesColumn(), and add one or more series using addSeries(const WDataSeries&). Each series corresponds to one data column that holds Y data.
A cartesian chart is either a CategoryChart or a ScatterPlot.
In a CategoryChart, the X series represent different categories, which are listed consecutively in model row order. The X axis scale is set to CategoryScale.
A category chart with bar series
In a ScatterPlot, the X series data are interpreted as numbers on a numerical scale. The scale for the X axis defaults to a LinearScale, but this may be changed to a DateScale when the X series contains dates (of type WDate) to create a time series chart, or to a LogScale. A ScatterPlot supports the same types of data series as a CategoryChart, but does not support stacking.
A time series scatter plot with line series
chart->axis(Y2Axis).setVisible(true);
By default a chart has a horizontal X axis and a vertical Y axis, which corresponds to a Vertical orientation. The orientation may be changed to Horizontal using setOrientation().
The styling of the series data are dictated by a palette which may be set using setPalette(WChartPalette *), but may be overridden by settings in each data series.
Wt::Chart::WCartesianChart::WCartesianChart | ( | WContainerWidget * | parent = 0 |
) |
Create a new cartesian chart.
Creates a cartesian chart of type CategoryChart.
Wt::Chart::WCartesianChart::WCartesianChart | ( | ChartType | type, | |
WContainerWidget * | parent = 0 | |||
) |
Create a new cartesian chart.
Creates a cartesian chart of the indicated type.
void Wt::Chart::WCartesianChart::setType | ( | ChartType | type | ) |
Change the chart type.
The chart type determines how (x,y) data are interpreted. In a CategoryChart, the X values are categories, and these are plotted consecutively, evenly spaced, and in row order. In a ScatterPlot, the X values are interpreted numerically (as for Y values).
The default chart type is a CategoryChart.
ChartType Wt::Chart::WCartesianChart::type | ( | ) | const [inline] |
Returns the chart type.
void Wt::Chart::WCartesianChart::setOrientation | ( | Orientation | orientation | ) |
Change the chart orientation.
Sets the chart orientation, which corresponds to the orientation of the Y axis: a Vertical orientation corresponds to the conventional way of a horizontal X axis and vertical Y axis. A Horizontal orientation is the other way around.
The default orientation is Vertical.
Orientation Wt::Chart::WCartesianChart::orientation | ( | ) | const [inline] |
void Wt::Chart::WCartesianChart::setXSeriesColumn | ( | int | modelColumn | ) |
Change the the model column for the X series.
Use this method to specify the data for the X series. For a ScatterPlot this is mandatory, while for a CategoryChart, if not specified, an increasing series of integer numbers will be used (1, 2, ...).
The default value is -1 (not specified).
int Wt::Chart::WCartesianChart::XSeriesColumn | ( | ) | const [inline] |
void Wt::Chart::WCartesianChart::addSeries | ( | const WDataSeries & | series | ) |
Add a data series.
A single chart may display one or more data series. Each data series displays data from a single model column in the chart. Series are plotted in the order that they have been added to the chart.
void Wt::Chart::WCartesianChart::removeSeries | ( | int | modelColumn | ) |
Remove a data series.
This removes the first data series which plots the given modelColumn.
void Wt::Chart::WCartesianChart::setSeries | ( | const std::vector< WDataSeries > & | series | ) |
Change all data series.
Replaces the current list of series with the new list.
WDataSeries & Wt::Chart::WCartesianChart::series | ( | int | modelColumn | ) |
Returns a data series corresponding to a data column.
Returns a reference to the first data series that plots data from modelColumn.
const WDataSeries & Wt::Chart::WCartesianChart::series | ( | int | modelColumn | ) | const |
Returns a data series corresponding to a data column.
Returns a const reference to the first data series that plots data from modelColumn.
const std::vector<WDataSeries>& Wt::Chart::WCartesianChart::series | ( | ) | const [inline] |
Returns a list with the current data series.
Returns the complete list of current data series.
Access a chart axis.
Returns a reference to the specified axis.
Access a chart axis.
Returns a const reference to the specified axis.
void Wt::Chart::WCartesianChart::setBarMargin | ( | double | margin | ) |
Change the margin between bars of different series.
Use this method to change the margin that is set between bars of different series. The margin is specified as a fraction of the width. For example, a value of 0.1 adds a 10% margin between bars of each series. Negative values are also allowed. For example, use a margin of -1 to plot the bars of different series on top of each other.
The default value is 0.
double Wt::Chart::WCartesianChart::barMargin | ( | ) | const [inline] |
void Wt::Chart::WCartesianChart::setLegendEnabled | ( | bool | enabled | ) |
Enable the legend.
If enabled is true, then a default legend is added to the right of the chart. You should provide space for the legend using the setChartPadding() method. Only series for which the legend is enabled or included in this legend (see WDataSeries::isLegendEnabled()).
To have more control over the legend, you could reimplement the renderLegendItem() method to customize how one item in the legend is rendered, or, alternatively you could reimplement the paint(WPainter& painter, const WRectF&) method in which you use the renderLegendItem() method repeatedly to render a legend at an arbitrary position.
The default value is false.
bool Wt::Chart::WCartesianChart::isLegendEnabled | ( | ) | const [inline] |
void Wt::Chart::WCartesianChart::paint | ( | WPainter & | painter, | |
const WRectF & | rectangle = WRectF() | |||
) | const [virtual] |
Paint the chart in a rectangle of the given painter.
Paints the chart inside the painter, in the area indicated by rectangle. When rectangle is a null rectangle, the entire painter window is used.
Implements Wt::Chart::WAbstractChart.
void Wt::Chart::WCartesianChart::drawMarker | ( | const WDataSeries & | series, | |
WPainterPath & | result | |||
) | const [virtual] |
Draws the marker for a given data series.
Draws the marker for the indicated series in the result. This method is called while painting the chart, and you may want to reimplement this method if you wish to provide a custom marker for a particular data series.
void Wt::Chart::WCartesianChart::renderLegendItem | ( | WPainter & | painter, | |
const WPointF & | pos, | |||
const WDataSeries & | series | |||
) | const [virtual] |
Renders the legend item for a given data series.
Renders the legend item for the indicated series in the paintert at position pos. The default implementation draws the marker, and the series description to the right. The series description is taken from the model's header data for that series' data column.
This method is called while painting the chart, and you may want to reimplement this method if you wish to provide a custom marker for a particular data series.
void Wt::Chart::WCartesianChart::paintEvent | ( | WPaintDevice * | paintDevice | ) | [protected, virtual] |
Paint the widget.
You should reimplement this method to paint the contents of the widget, using the given paintDevice.
Implements Wt::WPaintedWidget.
WChart2DRenderer * Wt::Chart::WCartesianChart::createRenderer | ( | WPainter & | painter, | |
const WRectF & | rectangle | |||
) | const [protected, virtual] |
Create a renderer which renders the chart.
The rendering of the chart is delegated to a WChart2DRenderer class, which will render the chart within the rectangle of the painter.
You may want to reimplement this method if you wish to override one or more aspects of the rendering, by returning an new instance of a specialized WChart2DRenderer class.
After rendering, the renderer is deleted.
void Wt::Chart::WCartesianChart::modelColumnsInserted | ( | const WModelIndex & | parent, | |
int | start, | |||
int | end | |||
) | [private, virtual] |
Method called when colums have been inserted in the model.
Implements Wt::Chart::WAbstractChart.
void Wt::Chart::WCartesianChart::modelColumnsRemoved | ( | const WModelIndex & | parent, | |
int | start, | |||
int | end | |||
) | [private, virtual] |
Method called when colums have been removed from the model.
Implements Wt::Chart::WAbstractChart.
void Wt::Chart::WCartesianChart::modelRowsInserted | ( | const WModelIndex & | parent, | |
int | start, | |||
int | end | |||
) | [private, virtual] |
Method called when rows have been inserted from the model.
Implements Wt::Chart::WAbstractChart.
void Wt::Chart::WCartesianChart::modelRowsRemoved | ( | const WModelIndex & | parent, | |
int | start, | |||
int | end | |||
) | [private, virtual] |
Method called when rows have been removed from the model.
Implements Wt::Chart::WAbstractChart.
void Wt::Chart::WCartesianChart::modelDataChanged | ( | const WModelIndex & | topLeft, | |
const WModelIndex & | bottomRight | |||
) | [private, virtual] |
Method called when data has been changed in the model.
Implements Wt::Chart::WAbstractChart.