ChartDirector应用笔记（二）

关于Simple Bar Chart

Simple bar chart是XYChart大类中的Bar chart类型中的最简单的例子。Bar chart的表现形式简单直观，在数据量较少、数据维度简单等场景下有较好的适用性。对于一个Bar chart，具有俩个重要的组成部分：XY坐标系，Bars。XY坐标具有坐标值、名称等属性，Bar之间具有颜色、间距、宽度等属性。下面的应用实例以Qt为基础，编写了一个简单的对话框程序，展示了ChartDirector类库和Qt结合的一般形式。

效果图

图表数据是随意添加的，添加了保存功能，目前只能保存为内置的文件名和文件格式。

关键代码解读

源代码主要分成两个部分：第一部分是主窗口布局，以XYChartDemo类为主；第二部分实现图表显示，以ImagePanel类为主。下面分别说明：

xychartdemo.h：XYChartDemo类继承自QDialog类，负责窗口绘制和显示。成员包含一个指向ImagePanel对象的指针，其他的成员主要用于窗口布局。

 1 class XYChartDemo : public QDialog

 2 {

 3     Q_OBJECT

 4 

 5 public:

 6     XYChartDemo(QWidget *parent = 0);

 7     ~XYChartDemo();

 8 

 9 private:

10     Ui::XYChartDemoClass ui;

11 

12     ImagePanel* m_panel;

13     QPushButton* m_quitBtn;

14     QPushButton* m_saveAsBtn;

15     QVBoxLayout* vlayout;

16     QHBoxLayout* m_layout;

17 };

xychartdemo.cpp：

 1 XYChartDemo::XYChartDemo(QWidget *parent)

 2     : QDialog(parent)

 3 {

 4     ui.setupUi(this);

 5 

 6     //setGeometry(40, 30 ,460, 310);

 7     setFixedSize(480, 310);

 8     

 9     m_quitBtn = new QPushButton("Quit");

10     m_saveAsBtn = new QPushButton("Save as...");

11 

12     m_layout = new QHBoxLayout;

13     m_panel = new ImagePanel;

14     m_layout->addWidget(m_panel, 1);

15 

16     vlayout = new QVBoxLayout;

17     vlayout->addWidget(m_quitBtn);

18     vlayout->addWidget(m_saveAsBtn);

19     vlayout->addStretch(1);

20     m_layout->addLayout(vlayout);

21     setLayout(m_layout);

22 

23     connect(m_quitBtn, SIGNAL(clicked()), this, SLOT(close()));

24     connect(m_saveAsBtn, SIGNAL(clicked()), m_panel, SLOT(onSaveAs()));

25 }

26 

27 XYChartDemo::~XYChartDemo()

28 {

29     delete m_panel;

30     delete m_quitBtn;

31     delete m_saveAsBtn;

32 

33     delete vlayout;  // the sublayout should be destroyed first.

34     delete m_layout;

35 }

构造函数首先对窗口组件进行初始化，添加好布局响应后设置了两个信号槽。第一个连接用于响应“quit”按钮，退出程序；第二个连接用于响应“保存”按钮，用户点击之后即将当前绘制的图表保存为指定格式。析构函数中对组件资源进行了释放，防止内存泄露。
imagepanel.h：

 1 class ImagePanel : public QWidget

 2 {

 3     Q_OBJECT

 4 

 5 public:

 6     ImagePanel(QWidget *parent = 0);

 7     ~ImagePanel();

 8 

 9 protected slots:

10     void onSaveAs();

11 

12 private:

13     QChartViewer* m_qViewer;

14     XYChart* m_chart;

15 };

ImagePanel类继承自QWidget类，用于图表显示。该类包含一个指向QChartViewer对象的指针和一个指向XYChart对象的指针。QChartViewer类在前面说过了，是一个继承自QLabel类的组件类，连接ChartDirector类库和Qt框架。再看看实现文件imagepanel.cpp：

 1 ImagePanel::ImagePanel(QWidget *parent)

 2     : QWidget(parent)

 3 {

 4     m_qViewer = new QChartViewer(this);

 5 

 6     const double data[] = {34, 56, 12, 58, 98};

 7     const char* lbels[] = {"Mon", "Tue", "Wed", "Thu", "Fri"};

 8 

 9     m_chart = new XYChart(400, 300);

10     m_chart->setPlotArea(35, 25, 335, 240);

11 

12     // set the color of bar.

13     BarLayer* blayer = m_chart->addBarLayer(DoubleArray(data, (int)(sizeof(data)/sizeof(data[0]))), 0xFF);

14     m_chart->xAxis()->setLabels(StringArray(lbels, (int)(sizeof(lbels)/sizeof(lbels[0]))));

15 

16     blayer->setBarGap(0.5);

17 

18     m_qViewer->setChart(m_chart);

19 }

如上一篇文件所说的那样，先分配一个XYChart对象。传递绘制区域（400, 300）作为参数调用XYChart的构造函数构造一个XYChart对象；然后调用setPlotArea设置好XY坐标系的位置的坐标区域。在该坐标区域内，可以绘制各种线条和图形。值得注意的是，X、Y轴上面的坐标值和坐标名并不属于PlotArea区域。调用addBarLayer()是一个较为重要的步骤，这里因为要绘制的是Bar chart, 所以使用了addBarLayer()。注意该函数的最后一个参数，0xFF指定了绘制出来的Bar的颜色。需要设定为其他颜色的Bar可以在这里设置。然后就是调用xAxis()等函数设置坐标参数，setChart()函数用于将chart对象设置到QChartViewer对象。这样，就可以在Qt窗口中看到ChartDirector绘制的图表了。

小结

总的来说，绘制过程还是比较简单的。当然，这个图表只是一个较为简单的例子，所以在流程上和代码上并无复杂性可言。本代码在编写过程中使用了VS2010作为编辑器，所以在调用ChartDirector的时候只需要在项目属性中设置好库的路径即可。另外，还需在主程序运行前指定加载lib文件：#pragma comment(lib, "chartdir51.lib")。最后，还需要加ChartDirector库的dll文件复制到生成的可执行文件所在的目录下才能运行，当然其他方法也是存在的。后续将陆续放出更为复杂的图表应用实例。