综述

这个控件是用来展示2D数据，如下面的图片。

介绍

对于我之前的一个项目，我需要在图表控件上显示连续的数据流。 我决定开发自己的控件，因为我找不到任何可以提供所需灵活性的自由软件控件。 其中一个主要的限制是，控件必须绘制大量的数据，并能够迅速显示它（在Pocket PC上）。 控件能够通过仅绘制新的数据点而不是完整的数据序列来做到这一点并且图表还能够显示静态数据。
这种控件是我长时间工作的结果，而且费尽周折地为了提供足够的灵活性来供需要它的人使用。 对于使用者反馈我表示由衷的感谢：一个邮件，留言板中的一一句话或只是对本文评级。 当我不知道是否还有人使用它时，我就没有必要维护这个控件了。

免责声明

这个控件是我花费很长时间的开发的结果，因此我对代码的使用放置一些小条件：

该代码可以以编译的形式用于任何非商业和商业目的。代码可以被重新开发，只要它提供作者名字和完整的免责声明。 更改源代码需要得到作者的同意。

此代码不提供任何安全保证。 我不会对使用此代码造成的损失负责。 使用它需要自己承担风险。

This code may be used for any non-commercial
and commercial purposes in a compiled form.
The code may be redistributed as long as it remains
unmodified and providing that the author name
and the disclaimer remain intact. The sources
can be modified with the author consent only.

This code is provided without any guarantees.
I cannot be held responsible for the damage or
the loss of time it causes. Use it at your own risks.

鉴于开发这个控件所付出的努力，下面的要求并不过分： 如果你在在商业应用程序中使用这个控件，那么请给我发邮件让我知道。

主要特点

控件的主要特点是：

• 高速绘图（轴固定时），允许快速绘制数据
• 无限数量的数据序列（内存是限制）
• 每个数据序列的数据量不受限制
• 支持线图，点图，平面图，柱状图，K线图 和甘特图系列
• 最多四个轴（左，下，右和上轴）
• 标准轴，对数轴或日期/时间轴
• 自动伸缩的坐标轴, 翻转的坐标轴（相互独立）
• 轴标签
• 点标签
• 平滑的曲线
• 网格
• 图例和标题
• 交互性（在控件中发生特定事件时的通知）
• 支持手动缩放和鼠标平移
• 支持鼠标指针
• 支持轴上的滚动条
• 高度可定制（颜色，标题，标签，边缘，字体等）
• 支持UNICODE
• 支持打印和保存到图像文件

文档结构

本文通过一系列简短的教程来涵盖控件的大部分功能。 阅读本文后，您将能够快速地在自己的应用程序中使用本控件。

我决定从文章中删除所有的类和函数的文档，因为它不是非常友好并且我很难维护。 此外，随着代码的增长，要记录的类和函数的列表变得过于广泛以至于不能将所有内容放在文章中。 作为替代，我提供了一个doxygen文档，您可以从本文中（文章的开头）下载：只需下载“Doxygen文档”zip文件，解压所有文件，双击“Index.html”文件，进行查看。

入门学习

此图表控件允许您在屏幕上绘制一系列数据。 此控件可以添加几个不同类型数据序列并且最多可以使用四个轴。 添加到图表的数据序列与一个水平轴（底部或顶部）和一个垂直轴（右侧或左侧）相关联。 这两个轴控制数据序列在图表上的显示方式。
为了能够在应用程序中使用次图表控件，您首先需要在自己的工程里添加源代码zip中包含的文件。

注意：控件在内部使用动态转型，因此必须启用RTTI（RunTime Type Information 运行时自动类型识别的机制），否则可能会发生崩溃。 默认情况下，VC6没有启用RTTI，因此要启用它打开项目设置 - >“C / C ++”选项卡 - >“C ++语言”类别，并确保“Enable Run-Time Type Information (RTTI) “选项已选中。

在应用程序中使用图表控件有两种方法：手动插入，或通过资源编辑器插入。

手动插入

1.#include "ChartCtrl"添加在对话框（Dialog）类的头文件中
2.在对话框类中添加变量CChartCtrl:

    //{{AFX_DATA(CChartDemoDlg)
    //}}AFX_DATA

    CChartCtrl m_ChartCtrl;

3.在对话框类的OnInitDialog方法中添加这个控件的Create方法。

使用资源管理器

1.向对话框资源添加自定义控件，打开控件的属性，并为Class属性指定ChartCtrl。 为了避免滚动条上的闪烁，必须设置WS_CLIPCHILDREN样式（0x02000000L），如图所示。

2.#include "ChartCtrl.h"添加在对话框（Dialog）类的头文件中
3.在对话框类中添加变量CChartCtrl:

    //{{AFX_DATA(CChartDemoDlg)
    //}}AFX_DATA

    CChartCtrl m_ChartCtrl;

4.在DoDataExchange函数中添加DDX_Control（不要忘了更改ID号和控件名字）:

Add a variable of type CChartCtrl in your dialog class: 
Hide   Copy Code
//{{AFX_DATA(CChartDemoDlg)
//}}AFX_DATA

操作数据序列

几种类型的数据序列可以添加到控制：点序列，线序列，曲面序列，柱状图序列，K线图序列或甘特图序列。 点的数据格式可能因序列而异（例如，K线图和甘特图系列使用不同的点格式）。

Series type	Description	Create function	Point type
Point series	Each data point is represented by a single point on the screen. The appearance of the point can be customized.	CreatePointsSerie	SChartXYPoint
Line series	The data points are connected through a line. The appearance of this line can be customized and it can also be smoothed.	CreateLineSerie	SChartXYPoint
Surface series	The data points are connected through a line and the area under this line is filled with a specific brush. The series can also be displayed vertically.	CreateSurfaceSerie	SChartXYPoint
Bar series	Each data point is plotted as a vertical bar of a certain width. Multiple bar series can be stacked next to each other without overlapping. The bars can also be plotted horizontally.	CreateBarSerie	SChartXYPoint
Candlestick series	Each data point is made of five attributes: the low value, the high value, the open value, the close value and the X value (time). Each point is drawn as a candlestick. This series is used for plotting financial data.	CreateCandlestickSerie	SChartCandlestickPoint
Gantt series	Each data point is made of three attributes: the start and end time and a Y value. Each point is drawn as a horizontal bar starting at the start time and finishing at the end time. The bar is positioned along the Y axis at its Y value.	CreateGanttSerie	SChartGanttPoint

一旦你选择了一种系列，你可以通过调用上表中列出的CChartCtrl类的辅助函数之一将其添加到图表中。 这些函数接受两个可选参数：两个布尔值来确定描述该系列是连接到副水平轴（顶轴）或者是连接大副垂直轴（右轴）。 如果未指定参数，则数据系列将附加到主水平轴（底部轴）和主垂直轴（左轴）。

警告: 在将任何系列添加到图表之前，您需要创建该系列所连接的两个轴。 如果不这样做，将导致控件失效（assert）。 有关详细信息，请参见“操纵轴”一节。

一旦将系列添加到图表后，我们就可以使用数据填充该图表。 有两种方法：将数据放到一个单元中一起添加，或者逐点添加。 后者用于有动态数据时：每次调用函数时都会更新图表。 虽然这个调用是快速的（在某些特定条件下），但是最好尽可能地将数据放到一个单元中。 下面是一个简单代码示例，它在图表中创建两个系列，并用数据填充它们：一个系列在初始化时完全填充，另一个系列在调用OnDataReceived函数（仅存在于此示例的目的）时填充。 m_pLineSeries，m_pPointsSeries和m_ChartCtrl是CMyClass类的成员变量。

void CMyClass::Init()
{
  ....  // SNIP: Creation of the axes in the chart. This MUST be done before.
  m_pLineSeries = m_ChartCtrl.CreateLineSerie();
  m_pPointsSeries = m_ChartCtrl.CreatePointsSerie();

  double YValues[10];
  for (inti=0;i<10;i++)
    XValues[i] = YValues[i] = i;
  m_pLineSerie->SetPoints(XValues,YValues,10);
}

void CMyClass::OnDataReceived(double X, double Y)
{
  m_pPointsSeries->AddPoint(X, Y);
}

所有系列类继承自同一抽象基类：CChartSerie。该类处理所有系列通用的功能，但对具体的数据点没有任何处理功能。点的概念在子类CChartSerieBase中引入，它是一个模板类，模板参数是要操作为点的数据类型。这很重要，因为序列可能必须处理不同的数据类型：例如点序列操作具有X和Y值的点，但是K线图系列操纵具有5个值（打开，关闭，高，低和时间值）的点。其他系列继承自CChartSerieBase并提供他们操作的数据类型。 CChartSerieBase类已经处理了大多数数据管理，并通过纯虚函数将渲染委托给子类。每个系列在创建时也会分配一个Id。此标识可通过CChartSerie :: GetSerieId（）检索，并可用于从图表中删除该系列。

该系列的一个重要特征是控制点的顺序：该系列中的所有点将根据它们的值重新排序。 默认情况下，点是基于它们的X值排序的，但您可以通过对它们的Y值排序或不对它们进行排序来改变这种行为（在这种情况下，系列保持将点添加到系列中的顺序 ）。 对点进行排序会对性能产生影响：如果点是有序的，则控件能够从完整系列中检索第一个和最后一个可见点，并且仅绘制两个点之间的点。 另一方面，你将不能绘制像椭圆形的曲线。 您可以通过调用CChartSerieBase :: SetSeriesOrdering来更改点的顺序。

控件中的不同系列的功能通常是不言自明的。 然而，柱状图系列需要一些解释。

柱状图系列

这个系列有点特别，如果其中几个在同一个控件上绘制在一起，他们将互相影响。 目的是能够绘制多个条形图系列，而不会重叠：它们是彼此相邻绘制的。 为此，您需要指定每个所属的组（一个简单的整数标识符）。 同一组的系列彼此相邻地绘制（或者对于水平条在彼此的顶部）：参见两个图形的示例。 设置组ID是通过SetGroupId函数完成的。

Bar series with the same group Id	Bar series with different group Id

您还可以通过调用SetInterSpace静态函数来控制所有柱形图之间剩余的空间的宽度。 这将为所有系列设置以像素为单位的空间（因此，如果显示多于两个系列，则在任何位置使用相同的空间）。 注意，您可以通过调用SetBarWidth单独设置柱状图系列的宽度。

在点上添加标签

一旦使用数据填充您的系列，您还可以在系列的特定点上添加标签：这个标签始终附加到特定点。 现在，只提供一种类型的标签，气泡标签：包含文本的圆角矩形并用线连接到特定点上。 当然，如果需要，您也可以提供自己的自定义标签（参见“扩展功能”一节）。
有两种方式创建文本标签：静态创建标签时，或动态注册一个对象，当标签请求时，它将提供文本。 第一种方法是最简单的，但也不太灵活。 下面是一个代码片段，显示如何做（假设m_pSeries已经创建并填充足够的数据）：

void CMyClass::Init()
{
  // SNIP...
  m_pSeries->CreateBalloonLabel(5,_T("This is a simple label"));
}

此调用将创建一个带有“This is a simple label”文本的标签，并将其附加到带索引为5的点。该函数返回一个指向新创建的标签的指针，以便您可以修改其某些属性或存储以供以后使用。

第二种方法有点复杂，但提供了更多的灵活性：例如，您可以以更方便的方式在标签中显示点属性（例如X值，Y值，…）。 为此，您必须创建一个继承自CChartLabelProvider <PointType>的类，并在创建标签时提供此类的实例。 此类是模板类，模板参数是标签附加到的系列的点类型。 这个类是一个简单的接口，你必须覆盖TChartString GetText（CChartSerieBase <PointType> * pSerie，unsigned uPtIndex）方法。 此函数应返回必须在标签中显示的文本。 它接收指向标签所附加的系列和点索引的指针。 这里有一个这样的标签提供程序类的例子：

class CCustomLabelProvider : public CChartLabelProvider<SChartXYPoint>
{
public:
  TChartString GetText(CChartSerieBase<SChartXYPoint>* pSeries, unsigned uPtIndex)
  {
    TChartStringStream ssText;
    SChartXYPoint Point = pSeries->GetPoint(uPtIndex);
    ssText << _T("X value="http://www.mamicode.com/)  << Point.X;
    return ssText.str();
  }
};

此代码段显示如何将其与标签一起使用。 注意m_pSeries应该是一个操作SChartXYPoint点（点，线，面或者柱系列）的系列。 如果不是这样，你的代码将给出一个编译错误。

void CMyClass::Init()
{
  // SNIP...

  m_pLabelProvider = new CCustomLabelProvider();
  m_pSeries->CreateBalloonLabel(5, m_pLabelProvider);
}

控件不获取指针的所有权，因此，当你不再需要时，你有责任删除它。 在上面的例子中，它通常会在CMyClass析构函数中被删除。 在上面的示例中，您可以为所有要添加的标签地方重复使用相同的标签类， 这也带来另一个优点：如果你想在运行时改变标签的格式，你只需要在CustomLabelProvider中添加代码。 不需要遍历所有现有标签并更改其文本。 当然，在这种情况下，需要刷新控件，因为必须重新绘制标签。 还要注意TChartStringStream类的用法，TChartStringStream类是由控件提供的别名（类似于TChartString）。 当UNICODE被定义时，它解析为std :: wstringstream，当未定义UNICODE时，解析为std :: stringstream。

对轴的操作

轴是图表的一个重要特征，因为它们控制不同系列在控制中的显示方式。 控件中最多可使用四个轴：底部，顶部，左侧和右侧。 控件的每个系列必须和一个水平轴和一个垂直轴相连接。 在图表中添加系列时指定这些轴。 底部和左侧轴是主轴，顶部和右侧轴是辅助轴（您将在控件的某些功能中遇到此问题）。 现在有三种类型的轴供选择：标准轴，对数轴和日期/时间轴。 您可以在不同位置选用不同类型的轴。

一旦您选择了在不同位置使用哪些轴，您需要先创建它们，然后才能向控件添加任何数据。 为此，通过指定轴附加在哪个位置，简单地调用CreateStandardAxis，CreateLogarithmicAxis或CreateDateTimeAxis。 如果已经在该位置创建了轴，则控件将销毁它并且用新的轴替换它。 这里有一个简单的代码片段，显示如何在底部创建日期/时间，在左侧创建一个标准轴：

void CMyClass::Init()
{
  CChartStandardAxis* pBottomAxis =
    m_ChartCtrl.CreateStandardAxis(CChartCtrl::BottomAxis);
  CChartLogarithmicAxis* pLeftAxis =
    m_ChartCtrl.CreateLogarithmicAxis(CChartCtrl::LeftAxis);
}

一旦创建了这些轴，就可以对它们设置一些属性。 大多数属性在所有轴类型之间共享（例如自动模式，最小值和最大值，轴标签，…）。 轴可以设置为三种“自动”模式：全自动，屏幕自动和手动模式。

• 全自动模式基于附加到该轴的所有系列计算轴最小值和最大值（所有系列的所有点的最小值用作轴的最小值，并使用所有系列的所有点的最大值 作为轴的最大值）。
• 屏幕自动模式基于与该轴相关的所有系列的所有可见点计算轴最小值和最大值。 例如，如果图表仅显示连接到手动底部轴和屏幕自动左侧轴的一个系列，则左侧轴将自适应于当前可见的点，并且不考虑这些点有可能超过底轴的范围（在全自动模式下，底轴外部的点将被考虑）。 警告：如果系列的两个轴都处于屏幕自动模式，则结果未定义。
• 在手动模式下，轴最小和最大值由用户设置，不由控件计算。

在使用自动轴模式下，如果将数据动态添加到控件，如果新的数据点位于轴的范围之外，那么控件将自动刷新。 这里是一个代码片段（继续前一个代码段），显示一个全自动轴（底部轴）和一个手动轴（左轴，它是一个对数轴）：

void CMyClass::Init()
{
  // SNIP ...
  pBottomAxis->SetAutomaticMode(CChartAxis::FullAutomatic);
  // The call to SetAutomaticMode(CChartAxis::NotAutomatic) is not
  // really needed because this is the default.
  pLeftAxis->SetAutomaticMode(CChartAxis::NotAutomatic);
  pLeftAxis->SetMinMax(0.01,1000);
}

处于离散模式下的轴

轴有一个模式是离散模式(默认禁用)。此模式指定轴不显示连续值，而只显示离散值，这些值是轴上刻度指定的值，而轴将不显示其他的值。尝试绘制不同于显示的节拍值的值是不可能的。让我们举一个例子：假设你有一个底部标准轴，间隔为1.0（所以，显示的蜱是1，2，3等等）。尝试绘制X值为0.5的点将在相同位置显示该点，就好像它的值为1.0。事实上，你可以认为两个刻度之间的区域是一个常量值。这就是为什么刻度标签显示在两个刻度的中间，而不是刻度本身。

这里有一个小代码片段，显示离散轴对系列显示方式的影响。代码片段下的两个图像显示启用离散模式（第一个图像）或禁用（第二个图像）的结果。

void CMyClass::Init()
{
  CChartStandardAxis* pBottomAxis =
    m_ChartCtrl.CreateStandardAxis(CChartCtrl::BottomAxis);
  pBottomAxis->SetMinMax(0, 10);
  CChartStandardAxis* pLeftAxis =
    m_ChartCtrl.CreateStandardAxis(CChartCtrl::LeftAxis);
  pLeftAxis->SetMinMax(0, 10);

  pBottomAxis->SetTickIncrement(false, 1.0);
  pBottomAxis->SetDiscrete(true);
  CChartLineSerie* pSeries = m_ChartCtrl.CreateLineSerie();
  double XVal[20];
  double YVal[20];
  for (int i=0; i<20; i++)
  {
    XVal[i] = YVal[i] = i/2.0;
  }
  pSeries->SetPoints(XVal,YVal,20);
}

Discrete mode enabled	Discrete mode disabled

使用日期/时间轴

使用日期/时间轴有点特别，下面是如何利用这个功能的解释。要了解日期/时间轴的重要一点是它们在COleDateTime对象内部工作。原因很简单：COleDateTime中有DATE类型的类，DATE类型是一个双精度型。由于图表中的点表示为双精度值，因此它非常适合：使用标准点（非日期/时间）和日期/时间点之间没有差异，这使得后者的使用不太复杂。所有点仍然存储为双精度型，无论是否是日期/时间。

创建日期/时间轴后，可以在控件中填充数据。为此目的，没有改变：你必须从CChartSerie类调用void AddPoint（double X，double Y）或void SetPoints（double * X，double * Y，int Count）。 CChartCtrl类提供了两个静态函数，让你从COleDateTime转换为双精度，反之亦然：

double DateToValue(const COleDateTime& Date)
COleDateTime ValueToDate(double Value)

如果您有另一种格式的日期（例如time_t或SYSTEMTIME），这不是一个问题，因为COleDateTime对象可以从不同的时间格式构造（检查COleDateTime类的MSDN文档，以了解从哪种格式可以构造它）。

填充数据后，可以配置轴以显示所需的内容。 与日期/时间轴相关的几个功能可用：

void SetDateTimeIncrement(TimeInterval Interval, int Multiplier)
void SetDateTimeFormat(bool bAutomatic, const TChartString& strFormat)
void SetReferenceTick(COleDateTime referenceTick)

第一个允许您指定轴上显示的两个节拍之间的间隔。两个节拍之间的间隔将遵守正确的时间，这意味着如果指定1个月的节拍增量(Interval=CChartAxis::tiMonth and Multiplier=1)，则两个节拍之间的间隔将是不规则的（28,30或31天）。第二个函数允许您指定刻度标签的格式。控件根据刻度间隔自动格式化刻度标签，但您可以通过调用此函数覆盖它。检查MSDN上的COleDateTime :: Format函数的文档以获取更多信息。最后，SetReferenceTick（COleDateTime referenceTick）函数允许您为轴指定一个参考标记。参考标记是用作绘制标记的参考的日期：在该日期总是存在标记。当您在SetDateTimeIncrement函数中指定的multiplier 不是1时，这很有用。例如，假设您指定了3个月的单位增量，并且您希望在2月（因此，5月，8月，…）有一个单位，那么您可以调用此函数将2月1日设置为参考单位。默认设置为2000年1月1日。

下面是一个简单的代码片段，它创建一个日期/时间轴，并显示不同函数的用法：

void CMyClass::Init()
{
  // Sets the axis min value to January 1st 2006 and the axis
  // max value to December 31st 2007.
  COleDateTime minValue(2006,1,1,0,0,0);
  COleDateTime maxValue(2007,12,31,0,0,0);
  pBottomAxis->SetMinMax(CChartCtrl::DateToValue(minValue),
            CChartCtrl::DateToValue(maxValue));
  // Sets the tick increment to 4 months (disable automatic tick increment)
  pBottomAxis->SetTickIncrement(false, CChartDateTimeAxis::tiMonth, 4);
  // Sets the tick label format for instance "Jan 2006"
  pBottomAxis->SetTickLabelFormat(false, _T("%b %Y"));
}

自定义外观

控件的外观方面可以根据不同的应用场景做出更改，比如控件的不同部分（图例，标题，背景，…）都可以修改。 所有与这些对象的交互是通过CChartCtrl类来实现：一些将根据需要创建（例如axes或series），一些在创建控件时创建（legend，titles，…）。 一般来说，你永远不会自己创建这些对象，而是将该任务委派给CChartCtrl类。 唯一的例外是当您要使用自定义轴或自定义系列（请参阅“扩展功能”部分）。 例如，下面是一个代码段，设置渐变背景，并将图例放在控件的底部：

void CMyClass::Init()
{
  // SNIP

  // Disable the refresh of the control
  m_ChartCtrl.EnableRefresh(false);
  // Set the gradient for the background
  m_ChartCtrl.SetBackGradient(RGB(255,255,255),RGB(125,125,255),gtVertical);
  // Dock the legend at the bottom
  m_ChartCtrl.GetLegend()->DockLegend(CChartLegend::dsDockBottom);
  // Specifies that the legend entries are horizontally stacked
  m_ChartCtrl.GetLegend()->SetHorizontalMode(true);
  // Re-enable the refresh of the control
  m_ChartCtrl.EnableRefresh(true);
}

重要：从版本1.4的控件，每次调用控件上的一个属性将导致控件的完全刷新（即使像改变一些文本的字体或对象的颜色）。 为了避免在没有必要时刷新控件（例如，当您同时更改多个属性时），应首先禁用刷新，更改属性，然后重新启用刷新，如上面的代码段所示 。

自从1.5版的控件开始支持UNICODE。 所有出现的std :: string对象已被TChartString对象替换，这只是一个typedef，如果未启用UNICODE，则解析为std :: string，并在启用UNICODE时解析为std :: wstring。

响应鼠标事件

有时，应用程序需要响应用户鼠标操作。 例如，如果用户点击点，则程序可以显示关于被点击的点的信息，这一节将解释如何做到。

虽然原理是有点不同，但是无论你想听在图表上的一般鼠标事件本身（点击轴，图例，…）或你是否对特定系列的鼠标事件感兴趣。 这两种情况都很容易实现。

响应图表上的鼠标事件

你必须实现CChartMouseListener接口，覆盖你感兴趣的方法，并通过调用CChartCtrl :: RegisterMouseListener（CChartMouseListener * pMouseListener）将该类的实例注册到图表控件。 根据鼠标事件发生在控件的哪个部分：标题，图例，轴或绘图区，调用该接口上的不同函数。 对于所有这些函数，总是传递两个参数：MouseEvent，它是列出鼠标事件类型（鼠标移动，左键单击，…）的枚举，以及一个CPoint对象，它包含的发生事件的点的屏幕坐标。 对于某些函数，需要时传递一些其他参数。 例如，当单击一个轴时，指向该轴的指针被传递给该函数。

下面是CChartMouseListener的实现，它对轴的点击作出反应，并显示一个消息框：

class CCustomMouseListener : public CChartMouseListener
{
public:
  void onm ouseEventAxis(MouseEvent mouseEvent, CPoint point,
          CChartAxis* pAxisClicked)
  {
    if (mouseEvent == CChartMouseListener::LButtonDoubleClick)
    {
      MessageBox(_T("Axis clicked"), _T("Info"), MB_OK);
    }
  }
};

然后你必须创建一个这个类的实例并注册它：

m_pMouseListener = new CCustomMouseListener();
m_ChartCtrl.RegisterMouseListener(m_pMouseListener);

这里也需要自己删除指针。

响应系列上的鼠标事件

响应系列上的事件与响应一般事件非常相似，只是监听器是CChartSeriesMouseListener的一个实例，它是一个模板类，模板参数是系列的点类型。 这是需要的，以避免当您要检索点的特定值时不必要的转型。 另一个区别是，您必须在系列本身上注册监听器，而不是在图表控件上注册。

下面是CChartSeriesMouseListener的实现，它对系列的点击做出反应，如果点击发生在点上，它将显示一个带有点的Y值的消息框：

class CCustomMouseListener : public CChartSeriesMouseListener<SChartXYPoint>
{
public:
  void onm ouseEventSeries(MouseEvent mouseEvent, CPoint point,
          CChartSerieBase<SChartXYPoint>* pSerie, unsigned uPointIndex)
  {
    if (mouseEvent == CChartMouseListener::LButtonDoubleClick &&
        uPointIndex != INVALID_POINT)
    {
      TChartStringStream ssText;
      SChartXYPoint Point = pSeries->GetPoint(uPointIndex);
      ssText << _T("Y value="http://www.mamicode.com/)  << Point.Y;
      TChartString strText = ssText.str();
      MessageBox(NULL,strText.c_str(), _T("Info"), MB_OK);
    }
  }
};

注意:当用户不点击一个点时，OnMouseEventSeries函数也可以被调用。 例如当用户在两个点之间但仍然在该系列上点击时情况。 在这种情况下，为uPointIndex参数传递INVALID_POINT。

然后，您必须创建此类的实例并将其注册到系列中：

m_pMouseListener = new CCustomMouseListener();
m_pSeries.RegisterMouseListener(m_pMouseListener);

注意：只有当系列操作SChartXYPoint类型的点（点，线，面或者柱状图系列）时，这才会起作用。 如果不是这样，您的代码将生成编译错误。

出于性能原因，禁止检测系列上的鼠标移动事件。 要启用它，请参阅doxygen文档中的CChartSerie :: EnableMouseNotifications函数。

使用光标

您还可以向控件添加光标。 支持两种类型的光标：“十字线”光标和“拉线”光标。 第一个是在鼠标移动的绘图区域上显示的简单十字，第二个是与特定轴关联的水平或垂直线，您可以通过单击它并使用鼠标移动来拖动。 对于每个光标，您可以注册一个侦听器，以便在移动光标时通知它。 这里是一段代码，用于创建与底部和左侧轴相关联的“十字准线”光标以及与底部轴相关联的“拉线”光标：

// Creates a cross-hair cursor associated with the two primary axes.
CChartCrossHairCursor* pCrossHair =
  m_ChartCtrl.CreateCrossHairCursor();
// Creates a dragline cursor associated with the bottom axis.
CChartDragLineCursor* pDragLine =
  m_ChartCtrl.CreateDragLineCursor(CChartCtrl::BottomAxis);
// Hides the mouse when it is over the plotting area.
m_ChartCtrl.ShowMouseCursor(false);

注意到对CChartCtrl :: ShowMouseCursor的调用结束。 默认情况下，鼠标总是可见的，但是当您使用十字光标时，当它在绘图区域时隐藏有时是需要的。

如果希望在光标位置更改时收到通知，则必须实现CChartCursorListener接口，创建其实例并使用光标注册它：

class CCustomCursorListener : public CChartCursorListener
{
public:
  void OnCursorMoved(CChartCursor *pCursor, double xValue, double yValue)
  {
    TChartStringStream ssText;
    ssText << _T("Cursor moved: xPos=") << xValue << _T(", yPos=") << yValue;

    // Do something with the string...
  }
};

CCustomCursorListener* pCursorListener = new CCustomCursorListener;
pDragLine->RegisterListener(pCursorListener);

OnCursorMoved函数接收一个X和Y值，但对于拖动光标，只使用这些值中的一个：如果光标与水平轴相关联，则使用X值，否则使用Y值。

使用平移和缩放功能

在版本1.1的控件中，缩放和平移功能已被添加到控件。 使用鼠标左键控制缩放，用鼠标右键控制平移。 要缩放图表的特定部分，只需左键单击图表（这将是缩放矩形的左上角），然后拖动到右下角。 将出现一个矩形。 一旦松开鼠标按钮，四个轴将自动调整到您选择的区域。 默认情况下启用缩放，但您可以通过调用CChartCtrl :: SetZoomEnabled（bool bEnabled）来禁用缩放。 您还可以通过调用CChartAxis :: SetZoomLimit（double dLimit）为每个轴指定缩放限制。 它指定缩放时轴的最小范围。 默认值为0.001。

要平移控件，右键单击控件上的某处并移动鼠标。 鼠标下的点将“跟随”鼠标的移动（实际上，轴的最小和最大值将改变）。 默认情况下启用平移，但您可以通过调用CChartCtrl :: SetPanEnabled（bool bEnabled）来禁用它。

如果您左键单击图表（例如开始缩放），但如果您移动到左上角，所有使用缩放和平移功能所做的修改将被取消（控制将处于它的状态 在使用平移和缩放操作之前）。 最后，还有一种方法通过调用CChartAxis :: SetPanZoomEnabled（bool bEnabled）禁用特定轴的平移和缩放功能。

利用高速功能

线和点系列允许以高速率绘制数据。 这通常在要绘制来自外部设备（例如，传感器）的数据时完成。 这是可能的，因为当您向此类系列添加点时，控件不会完全刷新，只会绘制最后一个点（或最后一个线段），这是非常有效的。 但是，如果希望控件能够足够快地绘制数据，则必须考虑几点。

一个重要的事情是，使用自动轴可能会降低很多性能。这是因为如果一个点绘制在轴范围之外，则轴范围将被自动调整，这意味着控制将被完全刷新。因此，如果您使用自动底部轴线并具有“滚动”轨迹，则每个新点都将位于轴的当前范围之外，并且将对每个点执行控制刷新。处理的更好的方法是使用固定轴并且每秒手动地增加轴的范围（或以合理的速率）。

另一个重要的点是，你不应该在向一个系列添加一个新点之后调用RefreshCtrl。这当然会完全地刷新控件，但是应该避免这样做。最后，如果您需要同时应用几个修改或添加几个点到控件，您应该在EnableRefresh（false）和EnableRefresh（true）之间封装这些调用（请参阅“自定义外观”部分）。

扩展功能

在某些特定情况下，您需要使用新功能扩展控件，例如新的系列类型。目前，您可以自定义四个组件：序列，轴，点标签和光标。

要提供新轴，新标签或新光标，您只需继承基类（CChartAxis，CChartLabel或CChartCursor）并实现所需的虚拟函数。一旦完成，您可以通过调用不同函数的自定义版本（CChartCtrl :: AttachCustomAxis，CChartCtrl :: AttachCustomLabel或CChartCtrl :: AttachCustomCursor）附加您的新对象。 CChartLabel类是一个模板类。这个主题有点广泛，进入了很多细节，但最简单的方法是看看不同的现有类。

如果你想提供新的系列，这有点不同：你首先要考虑你想要在你的系列中操纵的点的类型。如果你只需要使用X和Y值来操作点，那么你可以继承CChartXYSerie，它提供了很多功能来操作这些点。然后，您必须实现所需的虚拟函数。看看下面的系列：CChartLineSerie，CChartPointSerie，CChartSurfaceSerie和CChartBarSerie具体示例。

如果你的系列操纵其他类型的点，那么你首先必须为点包含以下方法创建一个结构：double GetX()，double GetXMin()，double GetXMax()，double GetY()，double GetYMin()和double GetYMax()。一旦完成，您必须继承CChartSerieBase并将此点作为模板参数。然后，您必须提供所需的虚拟功能。看看下面的系列具体例子：CChartCandlestickSerie和CChartGanttSerie。

Upgrading from Version 1.x to Version 2.0

在版本2.0中，对控件进行重构，导致API的更改。 主要的可见变化是每个轴类型现在有其单独的类（CChartStandardAxis，CChartDateTimeAxis和CChartLogarithmicAxis）。 这也意味着默认情况下没有创建轴，并且您必须在向图表添加系列之前自己创建轴（否则代码将断言）。 这包括在“操纵轴”部分。

另一个变化是添加系列到图表的方式：AddSerie已经在CChartCtrl类中删除，并已被帮助函数替代，以创建特定的系列类型（CreateLineSerie，CreatePointsSerie，…）。 这些函数返回确切的系列类型，因此不再需要铸造。 这在“操纵系列”一节中有详细描述。

Upgrading from Version 2.x to Version 3.x

版本3.0.0的主要变化是，系列基类现在已经作为模板类，模板参数是系列操作的点类型。如果您没有通过提供新的系列类型扩展控件，这将不会在您的代码中有所不同。如果你提供了一个新的系列类型，你的类必须继承CCharSerieBase并提供它操作的点的类型。如果你的系列使用只有X和Y值的点，你可以简单地继承CChartXYSerie。看看现有的系列更多的例子。

另一个小的修改是标签提供程序现在也是模板类（出于同样的原因）。并且监听系列中的鼠标事件现在从图表上的鼠标事件中分离出来。这两点在“在点上添加标签”部分和“鼠标事件通知”部分中有很好的解释。

最后，CChartAxis :: SetAutomatic方法已被标记为已弃用，您应该使用CChartAxis :: SetAutomaticMode（已经引入了一个额外的自动模式）。

例子

本节只是两个代码片段，显示了如何使用控件。 第一个片段再现了示波器示例的图像（参见本文顶部），第二个示例再现了“2008年收入”图像。 代码是文档化的，所以它不应该太难理解。

Oscilloscope example:

// Disable the refresh of the control (avoid multiple refresh).
m_ChartCtrl.EnableRefresh(false);
// Create a bottom and left axes
CChartStandardAxis* pBottomAxis =
  m_ChartCtrl.CreateStandardAxis(CChartCtrl::BottomAxis);
CChartStandardAxis* pLeftAxis =
  m_ChartCtrl.CreateStandardAxis(CChartCtrl::LeftAxis);
// Sets the min and max values of the bottom and left axis to -15 -> 15
pBottomAxis->SetMinMax(-15,15);
pLeftAxis->SetMinMax(-15,15);

// Add a new series of type line to the control and add data to it
CChartLineSerie* pLineSeries = m_ChartCtrl.CreateLineSerie();
// Specifies that the points in the series are not ordered (needed to be able
// to draw an ellipse).
pLineSeries->SetSeriesOrdering(poNoOrdering);
for (int i=0;i<361;i++)
{
  double X = 10 * sin(i/360.0 * 2 * 3.141592);
  double Y = 10 * cos( (i-60)/360.0 * 2 * 3.141592);

  pLineSeries->AddPoint(X,Y);
}

// Defines the different colors (back color, axes color, ...)
COLORREF BackColor = RGB(0,50,0);
COLORREF GridColor = RGB(0,180,0);
COLORREF TextColor = RGB(0,180,0);
COLORREF SerieColor = RGB(0,255,0);

// Specifies a sunken border for the control
m_ChartCtrl.SetEdgeType(EDGE_SUNKEN);

// Sets the color of the border and the back color
m_ChartCtrl.SetBorderColor(TextColor);
m_ChartCtrl.SetBackColor(BackColor);

//Sets the color of the different elements of the bottom axis
m_ChartCtrl.GetBottomAxis()->SetAxisColor(TextColor);
m_ChartCtrl.GetBottomAxis()->SetTextColor(TextColor);
m_ChartCtrl.GetBottomAxis()->GetGrid()->SetColor(GridColor);

// Sets the color of the different elements of the left axis
m_ChartCtrl.GetLeftAxis()->SetAxisColor(TextColor);
m_ChartCtrl.GetLeftAxis()->SetTextColor(TextColor);
m_ChartCtrl.GetLeftAxis()->GetGrid()->SetColor(GridColor);

// Sets the color of the title, change the font to Times New Roman
// and add a string
m_ChartCtrl.GetTitle()->SetColor(TextColor);
m_ChartCtrl.GetTitle()->SetFont(140,_T("Times New Roman"));
m_ChartCtrl.GetTitle()->AddString(_T("An example of oscilloscope"));

// Change the color of the line series
pLineSeries->SetColor(SerieColor);

// Finally re-enable the refresh of the control. This will refresh the
// control if any refresh was still ‘pending‘.
m_ChartCtrl.EnableRefresh(true);

“Income over 2008” example:

srand((unsigned int)time(NULL));

// Disable the refresh
m_ChartCtrl.EnableRefresh(false);
COleDateTime Min(2008,1,1,0,0,0);
COleDateTime Max(2008,10,1,0,0,0);
// Create the bottom axis and configure it properly
CChartDateTimeAxis* pBottomAxis =
  m_ChartCtrl.CreateDateTimeAxis(CChartCtrl::BottomAxis);
pBottomAxis->SetMinMax(Min,Max);
pBottomAxis->SetDiscrete(true);
pBottomAxis->SetTickIncrement(false,CChartDateTimeAxis::tiMonth,1);
pBottomAxis->SetTickLabelFormat(false,_T("%b"));
// Create the left axis and configure it properly
CChartStandardAxis* pLeftAxis =
  m_ChartCtrl.CreateStandardAxis(CChartCtrl::LeftAxis);
pLeftAxis->SetMinMax(0,100);
pLeftAxis->GetLabel()->SetText(_T("Units sold"));
// Create the right axis and configure it properly
CChartStandardAxis* pRightAxis =
  m_ChartCtrl.CreateStandardAxis(CChartCtrl::RightAxis);
pRightAxis->SetVisible(true);
pRightAxis->GetLabel()->SetText(_T("Income (kEuros)"));
pRightAxis->SetMinMax(0,200);

// Configure the legend
m_ChartCtrl.GetLegend()->SetVisible(true);
m_ChartCtrl.GetLegend()->SetHorizontalMode(true);
m_ChartCtrl.GetLegend()->UndockLegend(80,50);
// Add text to the title and set the font & color
m_ChartCtrl.GetTitle()->AddString(_T("Income over 2008"));
CChartFont titleFont;
titleFont.SetFont(_T("Arial Black"),120,true,false,true);
m_ChartCtrl.GetTitle()->SetFont(titleFont);
m_ChartCtrl.GetTitle()->SetColor(RGB(0,0,128));
// Sets a gradient background
m_ChartCtrl.SetBackGradient(RGB(255,255,255),RGB(150,150,255),gtVertical);

// Create two bar series and a line series and populate them with data
CChartBarSerie* pBarSeries1 = m_ChartCtrl.CreateBarSerie();
CChartBarSerie* pBarSeries2 = m_ChartCtrl.CreateBarSerie();
CChartLineSerie* pLineSeries = m_ChartCtrl.CreateLineSerie(false,true);
int lowIndex = -1;
int lowVal = 999;
for (int i=0;i<9;i++)
{
  COleDateTime TimeVal(2008,i+1,1,0,0,0);
  int DesktopVal = 20 + rand()%(100-30);
  pBarSeries1->AddPoint(TimeVal,DesktopVal);
  int LaptopVal = 10 + rand()%(80-20);
  pBarSeries2->AddPoint(TimeVal,LaptopVal);
  int Income = DesktopVal + LaptopVal*1.5;
  if (Income < lowVal)
  {
    lowVal = Income;
    lowIndex = i;
  }
  pLineSeries->AddPoint(TimeVal,Income);
}
// Configure the series properly
pBarSeries1->SetColor(RGB(255,0,0));
pBarSeries1->SetName(_T("Desktops"));
pBarSeries2->SetColor(RGB(68,68,255));
pBarSeries2->SetGradient(RGB(200,200,255),gtVerticalDouble);
pBarSeries2->SetName(_T("Laptops"));
pBarSeries2->SetBorderColor(RGB(0,0,255));
pBarSeries2->SetBorderWidth(3);
pLineSeries->SetColor(RGB(0,180,0));
pLineSeries->SetName(_T("Total income"));
pLineSeries->SetWidth(2);
pLineSeries->EnableShadow(true);

// Add a label on the line series.
TChartStringStream labelStream;
labelStream << _T("Min income: ") << lowVal;
CChartBalloonLabel<SChartXYPoint>* pLabel =
  pLineSeries->CreateBalloonLabel(lowIndex, labelStream.str() + _T(" kEuros"));
CChartFont labelFont;
labelFont.SetFont(_T("Microsoft Sans Serif"),100,false,true,false);
pLabel->SetFont(labelFont);

// Re enable the refresh
m_ChartCtrl.EnableRefresh(true);

Feedback

Quite a lot of work is involved in the development of this control and, as any other software project, it might still contain bugs or errors in the documentation. If you encounter such a problem, please let me know (even if you fixed it yourself) so that I can fix the issue as soon as possible. Other users of the control will thank you for that. The same if you encounter errors in the documentation or typos in the article.

I’m also more or less constantly working on this control to add new features. If you have some requirement for a nice feature that could be useful for others, please let me know and I’ll add it to my wishlist. However, as I’m working on this control in my spare time, my time is rather limited.

Finally, if you liked this control, do not hesitate to drop me a word in the discussion forum or to rate the article, this is much appreciated. Thank you.

History

• 08/05/2006: Release of version 1.0
• 19/08/2006: Release of version 1.1
  
  • Bug fix in ScreenToValue function (CChartAxis)
  • Bug fix in RemoveAllSeries function (CChartCtrl)
  • Added support for manual zoom
  • Added support for mouse panning
  • Ability to specify a tick increment on the axis
  • Added support for resizing the control
• 09/04/2007: Release of version 1.2
  
  • GDI leak corrected
  • Invisible series are not taken in account for auto axis and legend (thanks to jerminator-jp)
  • Ability to change the text color of the axis
  • Ability to change the color of the border of the drawing area
  • Surface series added
• 16/02/2008: Release of version 1.3
  
  • Added date/time axis
  • Bug fix in how the logarithmic labels are displayed (trailing 0)
  • Ability to change the color of the zoom rectangle
  • Removed compiler warnings for VC2005
  • Bug fix in the zoom
• 14/04/2008: Release of version 1.4
  
  • Added support for scrollbars
  • Bar series added
  • Legend can be docked on any side or floating
  • Support for legend in horizontal mode
  • Support for transparent background on the legend
  • Support for shadow for several objects
  • RemovePointsFromBegin, RemovePointsFromEnd and AddPoints in the CChartSeries class
  • Support for gradient background
  • EnableRefresh and UndoPanZoom functions added in CChartCtrl
  • Possibility to enable/disable the zoom for a specific axis and to set its limit
  • Speed improvement on the series (min and max cached, ordering of the series)
  • Series can be removed using their pointers
  • Bug fix for invisible series in the legend
  • Bug fix for logarithmic axis (1 digit was not displayed)
  • Bug fix when removing series from the control
  • Bug fix if the pen width is bigger than 1 for line series
  • Bug fix for automatic axis
  • 20/08/2008: Release of version 1.5
  • Added support for UNICODE
  • Added support for printing
  • Auto-hide scrollbars
  • Baseline selection for bar series
  • Performance patch
  • Scrollbar flickering removed (see here)
  • Bug fix: scrollbar is now updated when axis is panned
  • Bug fix: calling AddPoint was not drawing the new point
  • Bug fix: tick labels for log axis were not always correct (rounding error)
  • Bug fix: last point of ChartPointSerie was not displayed
  • Bug fix: moving the mouse outside the control doesn’t stop the zoom or pan operation (the button can be released outside the control)
• 13/04/2009: Release of version 2.0
  
  • The different axis types are now separated into different classes
  • Modified the way to add series to the control for improved flexibility
  • Added cursors
  • Ability to display discrete axes
  • Ability to be notified about mouse events occurring on the control
  • Added labels on points
  • Ability to display a smooth curve
  • Added ChartFont: allows for italic, bold or underlined fonts
  • Added the SetReferenceTick function for date/time axis
  • Ability to store user data for each point
  • Series now have an Id
  • Removed the CChartObject class
  • Points are now stored in a standard array instead of a std::vector for efficiency
  • Binary search implemented for finding the first and last visible points (for efficiency)
  • The line series now uses PolyLine instead of MoveTo/LineTo (efficiency)
  • Bug fix when using date/time axis with a tick interval in years
  • Bug fix: bar series were drawn from the wrong axis
• 11/06/2009: Release of version 2.0.1
  
  • Optimization: the pan feature has been smoothed
  • Optimization: points with the same X and Y values are not plotted anymore for the line series.
  • Bug fix: in some situations, the code was crashing when accessing points outside the valid range
  • Bug fix: when series were removed, the legend was accessing removed series (which crashed)
  • Bug fix: when a series was cleared, new points were not drawn properly
  • Bug fix: inserting a point for which the X value already existed in the series did not add the point properly
  • Bug fix with the CChartFont class
• 07/08/2009: Release of version 2.0.2
  
  • Bug fix: the control was crashing when a series with no points and no ordering was added
  • Bug fix: the shadow of the line was not drawn correctly
  • Bug fix: when an automatic date/time axis was used without any data, the code crashed
• 28/12/2009: Release of version 3.0.0
  
  • Series are now template classes with the template parameter being the point type. This allows the control to manipulate any type of points
  • Added candlestick and Gantt series
  • Added support to save the chart to an image file
  • Bar series can be stacked
  • Added a new automatic mode for axes: the screen automatic mode
  • Listening for mouse events on a series has been moved to a CChartSeriesMouseListener class
  • Bug fix: when a point X or Y value is modified, the series is reordered
  • Bug fix: setting a tick increment on a standard axis did not show the digits properly
• 17/01/2010: Release of version 3.0.1
  
  • Bug fix: when using labels with the points series, the border of the points was changing color. Fixed by providing a way to specify the border color.
  • Bug fix: the code was crashing when clicking on a series without having registered a mouse listener on the series.
  • Bug fix: detection of mouse events on certain series type was crashing
  • Bug fix: CChartTitle::SetVisible was not implemented
• 13/07/2010: Release of version 3.0.2
  
  • Bug fix: the high-speed functionality has been removed by mistake
  • Bug fix: the draw function of the line series was not drawing points
  • Bug fix: replaced Clear() by clear() in the ClearSerie function.
  • Bug fix: Added implementation of ctor/dtor for the CChartCursorListener class
  • Bug fix: memory leak when the series was cleared (labels were not deleted)

Thanks

I would like to thank all the people from this community, they were a great help when I started programming. Thanks also to all the people who contributed to this control with their various help or feedback: toxcct, Chris Maunder, Kevin Hoffman, jerminator-jp, Laurie Gellatly, Eugene Pustovoyt, Andrej Ritter, Nick Holgate, Nick Schultz, Johann Obermayr, Pierre Schramm and Kevin Winter. A special thanks to Bruno Lavier for the time spent working on the control. I hope I didn’t forget anybody.

Links

• Chris Maunder’s Colour Picker Control (used in the demo application)
• Drawing smooth curves with Bezier Primitives

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)