为了让 MQL5 语言的程序员更加轻松地编程，设计师们创建了一个“标准库”，其中涵盖了几乎所有的 API MQL5 函数，而且使用它们也更加简单、方便。本文会试着创建一个信息面板，其中包含该标准库所使用的最大数量的类。
那么，这个库究竟是什么呢？本网站的“文档”版块如此描述其构成：
包含所有类代码的文件位于 MQL5/Include 文件夹。查看库代码时您就会发现，它只提供类，而不是函数。所以，想要使用它，您必须懂点面向对象编程 (OOP) 知识。
所有的库类（交易类除外）都源自 CObject 基类。为了展示，我们会试着构造一个 类图，因为我们已拥有其所要求的一切 - 基类及其继承子类。因为 MQL5 语言基本上就是 C++ 的一个子集，所以我们采用 IBM Rational Rose 工具，为 C++ 项目提供逆向工程工具，为图解的自动构造提供工具。
图 1. “标准库”类图解
我们不会显示类属性与方法，因为那样会让图表繁琐笨重。我们还会忽略聚合，因为它们对我们不重要。结果，我们只剩下了泛化（继承），借此我们可以查找类获得了哪些属性和方法。
从图表中可以看出，使用行、文件、图表、图形对象和数组的每一个库组件，都拥有自己的基类（分别为 CString、 CFile、 CChart、 CChartObject 及 CArray） - 皆继承自 CObject。使用指标 CIndicator 及其 CIndicators 辅类的基类继承自 CArrayObj，而对指标缓冲区类 CIndicatorBuffer 的访问权限则继承自 CArrayDouble。
图表中标深红色表明在实际的类、指标、数组和 ChartObjects 中不存在 - 它们都是集，其中包含使用指标、数组和图形对象的类。因为数量庞大，它们又都继承自一个父类，所以，我考虑将其适当简化，从而让图表不那么乱。比如说，“指标”包含 CiDEMA、 CiStdDev 等
还值得一提的是，亦可利用 Doxygen 文档系统的自动创建构造类图。从某种程度上讲，在该系统中执行要比 Rational Rose （可视化建模工具）中简单一些。有关 Doxygen 的更多详情，请见 MQL5 代码自动生成文档。
我们试着创建一个包含最大数量“标准库”类的信息表。
面板会显示哪些内容？有点类似 MetaTrader 5 的详情报告，即：
图 2. 详情报告的外观
我们可以看出，此报告会呈现一个余额图和一些交易数据。有关计算此类指标的方法的更多详情，请见《专家测试报告中的数字有何含义》一文。
因为此面板仅作信息用途，不执行任何交易操作，所以最好将其实现为某独立窗口中的一个指标，以避免关闭实际图表。而且，将其放入一个子窗口中还方便缩放，甚至只要一个简单的鼠标动作就可以关闭面板。
您可能还想要利用一个饼图来补充此报告，用其来展示在此工具上完成的、相对于交易总数的交易数量。
我们已经界定了自己的目标 - 我们需要主图表的子窗口中有一份详情报告。
我们将自己的信息面板作为一个类实现。开始吧：
//+------------------------------------------------------------------+ ///面板类 //+------------------------------------------------------------------+ class Board { //被保护的数据 protected: ///存储表格的子窗口编号 int wnd; ///成交数量数组 CArrayObj *Data; ///余额数据数组 CArrayDouble ChartData; ///界面元素数组 CChartObjectEdit cells[10][6]; ///图表的工作对象 CChart Chart; ///余额图表的工作对象 CChartObjectBmpLabel BalanceChart; ///饼图的工作对象 CChartObjectBmpLabel PieChart; ///饼图的数据 PieData *pie_data; //私有数据和方法 private: double net_profit; //这些变量将存储计算后的特征值 double gross_profit; double gross_loss; double profit_factor; double expected_payoff; double absolute_drawdown; double maximal_drawdown; double maximal_drawdown_pp; double relative_drawdown; double relative_drawdown_pp; int total; int short_positions; double short_positions_won; int long_positions; double long_positions_won; int profit_trades; double profit_trades_pp; int loss_trades; double loss_trades_pp; double largest_profit_trade; double largest_loss_trade; double average_profit_trade; double average_loss_trade; int maximum_consecutive_wins; double maximum_consecutive_wins_usd; int maximum_consecutive_losses; double maximum_consecutive_losses_usd; int maximum_consecutive_profit; double maximum_consecutive_profit_usd; int maximum_consecutive_loss; double maximum_consecutive_loss_usd; int average_consecutive_wins; int average_consecutive_losses; ///获取成交数据和余额的方法 void GetData(); ///计算特征值的方法 void Calculate(); ///构建图表的方法 void GetChart(int X_size,int Y_size,string request,string file_name); ///请求谷歌图表API的方法 string CreateGoogleRequest(int X_size,int Y_size,bool type); ///获取最佳字体大小的方法 int GetFontSize(int x,int y); string colors[12]; //文本显示颜色的数组 //公共方法 public: ///构造函数 void Board(); ///析构函数 void ~Board(); ///更新面板的方法 void Refresh(); ///创建界面元素的方法/ void CreateInterface(); };
受保护的类数据为界面元素以及交易、余额图和饼图数据（PieData 类将于下文讨论）。交易指标及一些方法属于私有。说它们私有，是因为用户没有直接访问它们的权限，它们只于类中计算，而且只能通过调用相应的公共方法才能计算。
界面创建与指标计算亦为私有方法，因为您在这里需要忍耐严格的方法调用顺序。比如说，没有用于计算的数据就不可能计算指标，不事先创建就不可能有要更新的界面。因此，我们可不会让用户“搬起石头砸自己的脚”。
我们立即来处理某个类的构造函数与析构函数，这样一来，我们一会就不必再返回来了：
//+------------------------------------------------------------------+ ///构造函数 //+------------------------------------------------------------------+ void Board::Board() { Chart.Attach(); //将当前图表加到类的实例中 wnd=ChartWindowFind(Chart.ChartId(),"IT"); //查找指标窗口 Data = new CArrayObj; //创建CArrayObj类的实例 pie_data=new PieData; //创建PieData类的实例 //填充颜色数组 colors[0]="003366"; colors[1]="00FF66"; colors[2]="990066"; colors[3]="FFFF33"; colors[4]="FF0099"; colors[5]="CC00FF"; colors[6]="990000"; colors[7]="3300CC"; colors[8]="000033"; colors[9]="FFCCFF"; colors[10]="CC6633"; colors[11]="FF0000"; } //+------------------------------------------------------------------+ ///析构函数 //+------------------------------------------------------------------+ void Board::~Board() { if(CheckPointer(Data)!=POINTER_INVALID) delete Data; //删除交易数据 if(CheckPointer(pie_data)!=POINTER_INVALID) delete pie_data; ChartData.Shutdown(); //删除余额数据 Chart.Detach(); //从图表中卸载 for(int i=0;i<10;i++) //删除所有界面元素 for(int j=0;j<6;j++) cells[i][j].Delete(); BalanceChart.Delete(); //删除余额图表 PieChart.Delete(); //删除饼图表 }
在构造函数中，我们会在 Attach() 方法的帮助下，将某 CChart 类型对象关联到当前图表。而于析构函数中调用的 Detach() 方法则会解除图表与对象的关联。作为 CArrayObj 类型对象指针的数据对象，会接收利用 new 操作动态创建的对象地址，并利用 delete 操作符于析构函数中移除。不要忘记在删除之前利用 CheckPointer() 检查有无对象存在，否则会出现错误。
有关 CArrayObj 类的更多详情，我们后文还有详述。同其它类一样，CArrayDouble 类的 Shutdown() 方法亦继承自 CArray 类 （参见类图解），会清理和释放被对象占用内存。CChartObject 类继承子类的 Delete() 方法会由图表中移除对象。
由此，构造函数分配内存、析构函数则释放内存，并移除由此类创建的图形对象。
现在，我们来处理界面。前面讲过，CreateInterface() 方法会创建一个面板界面：
//+------------------------------------------------------------------+ ///CreateInterface函数 //+------------------------------------------------------------------+ void Board::CreateInterface() { //取指标窗口的宽度 int x_size=Chart.WidthInPixels(); //以及高度 int y_size=Chart.GetInteger(CHART_HEIGHT_IN_PIXELS,wnd); //计算余额图会占据多少空间 double chart_border=y_size*(1.0-(Chart_ratio/100.0)); if(Chart_ratio<100)//如果余额图占据了整个表格 { for(int i=0;i<10;i++)//创建列 { for(int j=0;j<6;j++)//创建行 { cells[i][j].Create(Chart.ChartId(),"InfBoard "+IntegerToString(i)+" "+IntegerToString(j), wnd,j*(x_size/6.0),i*(chart_border/10.0),x_size/6.0,chart_border/10.0); //设置可选属性为false cells[i][j].Selectable(false); //设置文本为只读 cells[i][j].ReadOnly(true); //设置字体大小 cells[i][j].FontSize(GetFontSize(x_size/6.0, chart_border/10.0)); cells[i][j].Font("Arial"); //字体名称 cells[i][j].Color(text_color);//字体颜色 } } } if(Chart_ratio>0)//如果需要余额图 { //创建余额图 BalanceChart.Create(Chart.ChartId(), "InfBoard chart", wnd, 0, chart_border); //设置可选属性为false BalanceChart.Selectable(false); //创建饼图 PieChart.Create(Chart.ChartId(), "InfBoard pie_chart", wnd, x_size*0.75, chart_border); PieChart.Selectable(false);//设置可选属性为false } Refresh();//刷新面板 }
想要紧凑布置所有元素，首先，利用 CChart 类的 WidthInPixels() 与 GetInteger() 方法，查明面板所放置的指标子窗口的长度和宽度。然后我们创建包含指标值的单元格 - 利用 CChartObjectEdit 类的 Create() 方法（创建 "input field"），所有继承子类都拥有 CChartObject 的这种方法。
使用标准库执行此类型的操作有多方便，大家注意到没有？如果没有它，我们必须利用 ObjectCreate 函数创建每一个对象，并利用 ObjectSet 之类的函数设置各对象的属性，进而导致代码冗余。而且，当我们之后想要更改对象的属性时，就必须得仔细监管对象的名称才能避免混淆。现在我们可以轻松地创建一个图形对象数组，并可随时根据需要全盘查看。
此外，我们还可以利用一个函数获取/设置对象的属性 - 只要其为类的重载创造者，比如 CChartObject 类的 Color() 方法。如果利用其设置它们的参数调用或无参数 - 它会返回对象颜色。将饼图放在余额图旁边，会占用整个屏幕宽度的四分之一。
Refresh method() 会更新面板。更新都包括哪些内容呢？我们需要算出指标的总数，将其输入图形对象中，如果其所在的窗口尺寸已有改变，则还要重新调整面板的大小。此面板应占据窗口的全部闲余空间。
//+------------------------------------------------------------------+ ///面板更新函数 //+------------------------------------------------------------------+ void Board::Refresh() { //检查服务器链接状态 if(!TerminalInfoInteger(TERMINAL_CONNECTED)) {Alert("No connection with the trading server!"); return;} //检查是否允许从动态链接库中引入函数 if(!TerminalInfoInteger(TERMINAL_DLLS_ALLOWED)) {Alert("DLLs are prohibited!"); return;} //计算特征值 Calculate(); //取指标窗口的宽度 int x_size=Chart.WidthInPixels(); //以及高度 int y_size=Chart.GetInteger(CHART_HEIGHT_IN_PIXELS,wnd); //计算余额图会占据多大空间 double chart_border=y_size*(1.0-(Chart_ratio/100.0)); string captions[10][6]= //界面元素名称数组 { {"Total Net Profit:"," ","Gross Profit:"," ","Gross Loss:"," "}, {"Profit Factor:"," ","Expected Payoff:"," ","",""}, {"Absolute Drawdown:"," ","Maximal Drawdown:"," ","Relative Drawdown:"," "}, {"Total Trades:"," ","Short Positions (won %):"," ","Long Positions (won %):"," "}, {"","","Profit Trades (% of total):"," ","Loss trades (% of total):"," "}, {"Largest","","profit trade:"," ","loss trade:"," "}, {"Average","","profit trade:"," ","loss trade:"," "}, {"Maximum","","consecutive wins ($):"," ","consecutive losses ($):"," "}, {"Maximal","","consecutive profit (count):"," ","consecutive loss (count):"," "}, {"Average","","consecutive wins:"," ","consecutive losses:"," "} }; //将计算所得值存入数组 captions[0][1]=DoubleToString(net_profit, 2); captions[0][3]=DoubleToString(gross_profit, 2); captions[0][5]=DoubleToString(gross_loss, 2); captions[1][1]=DoubleToString(profit_factor, 2); captions[1][3]=DoubleToString(expected_payoff, 2); captions[2][1]=DoubleToString(absolute_drawdown, 2); captions[2][3]=DoubleToString(maximal_drawdown, 2)+"("+DoubleToString(maximal_drawdown_pp, 2)+"%)"; captions[2][5]=DoubleToString(relative_drawdown_pp, 2)+"%("+DoubleToString(relative_drawdown, 2)+")"; captions[3][1]=IntegerToString(total); captions[3][3]=IntegerToString(short_positions)+"("+DoubleToString(short_positions_won, 2)+"%)"; captions[3][5]=IntegerToString(long_positions)+"("+DoubleToString(long_positions_won, 2)+"%)"; captions[4][3]=IntegerToString(profit_trades)+"("+DoubleToString(profit_trades_pp, 2)+"%)"; captions[4][5]=IntegerToString(loss_trades)+"("+DoubleToString(loss_trades_pp, 2)+"%)"; captions[5][3]=DoubleToString(largest_profit_trade, 2); captions[5][5]=DoubleToString(largest_loss_trade, 2); captions[6][3]=DoubleToString(average_profit_trade, 2); captions[6][5]=DoubleToString(average_loss_trade, 2); captions[7][3]=IntegerToString(maximum_consecutive_wins)+"("+DoubleToString(maximum_consecutive_wins_usd, 2)+")"; captions[7][5]=IntegerToString(maximum_consecutive_losses)+"("+DoubleToString(maximum_consecutive_losses_usd, 2)+")"; captions[8][3]=DoubleToString(maximum_consecutive_profit_usd, 2)+"("+IntegerToString(maximum_consecutive_profit)+")"; captions[8][5]=DoubleToString(maximum_consecutive_loss_usd, 2)+"("+IntegerToString(maximum_consecutive_loss)+")"; captions[9][3]=IntegerToString(average_consecutive_wins); captions[9][5]=IntegerToString(average_consecutive_losses); if(Chart_ratio<100) //如果余额图没有占据整个表格 { for(int i=0;i<10;i++) //遍历界面元素 { for(int j=0;j<6;j++) { //确定位置 cells[i][j].X_Distance(j*(x_size/6.0)); cells[i][j].Y_Distance(i*(chart_border/10.0)); //大小 cells[i][j].X_Size(x_size/6.0); cells[i][j].Y_Size(chart_border/10.0); //文本 cells[i][j].SetString(OBJPROP_TEXT,captions[i][j]); //字体大小 cells[i][j].FontSize(GetFontSize(x_size/6.0,chart_border/10.0)); } } } if(Chart_ratio>0)//如果需要余额图 { //刷新余额图 int X=x_size*0.75,Y=y_size-chart_border; //获取图表 GetChart(X,Y,CreateGoogleRequest(X,Y,true),"board_balance_chart"); //设置它的位置 BalanceChart.Y_Distance(chart_border); //确定文件名 BalanceChart.BmpFileOn("board_balance_chart.bmp"); BalanceChart.BmpFileOff("board_balance_chart.bmp"); //刷新饼图 X=x_size*0.25; //获取图表 GetChart(X,Y,CreateGoogleRequest(X,Y,false),"pie_chart"); //设置新位置 PieChart.Y_Distance(chart_border); PieChart.X_Distance(x_size*0.75); //确定文件名 PieChart.BmpFileOn("pie_chart.bmp"); PieChart.BmpFileOff("pie_chart.bmp"); } ChartRedraw(); //重绘图表 }
代码量非常大，类似于 CreateInterface() 方法，首先用 Calculate() 函数计算指标，然后将其输入图形对象，同时利用 X_Size() 与 Y_Size() 方法将对象尺寸调节为适应窗口大小。X_Distance 与 Y_Distance 方法会改变对象的位置。
多多注意 GetFontSize() 函数，它会选择一种字号，让文本不会在重新调整之后“溢出”窗口边界，并且相反情况下也不会太小。
我们更近距离地来研究一下此函数：
//引入动态链接库函数，度量字符串 #import "String_Metrics.dll" void GetStringMetrics(int font_size,int &X,int &Y); #import //+------------------------------------------------------------------+ ///确定最佳字体大小的函数 //+------------------------------------------------------------------+ int Board::GetFontSize(int x,int y) { int res=8; for(int i=15;i>=1;i--)//遍历不同的字体大小 { int X,Y; //这里我们输入坐标线 //确定坐标 GetStringMetrics(i,X,Y); //如果坐标线适合已设定的边界，返回字体大小 if(X<=x && Y<=y) return i; } return res; }
上面说过，GetStringMetrics() 函数由 DLL 导入，其代码可于档案 DLL_Sources.zip 中找到，必要时可以修改。我觉得如果您选择在项目中自行设计界面，它迟早有用。
我们已经完成了用户界面，现在开始着手交易指标的计算。
4. 交易指标的计算
Calculate() 方法会执行计算。
但我们还需要 GetData() 方法来接收必要数据：
//+------------------------------------------------------------------+ ///接收成交和余额数据的函数 //+------------------------------------------------------------------+ void Board::GetData() { //删除旧数据 Data.Shutdown(); ChartData.Shutdown(); pie_data.Shutdown(); //准备所有成交历史 HistorySelect(0,TimeCurrent()); CAccountInfo acc_inf; //对帐户进行操作的对象 //计算余额 double balance=acc_inf.Balance(); double store=0; //余额 long_positions=0; short_positions=0; long_positions_won=0; short_positions_won=0; for(int i=0;i<HistoryDealsTotal();i++) //遍历所有成交历史 { CDealInfo deal; //成交信息存储在此 deal.Ticket(HistoryDealGetTicket(i));//获取成交单号 //如果交易产生结果（退出市场） if(deal.Ticket()>=0 && deal.Entry()==DEAL_ENTRY_OUT) { pie_data.Add(deal.Symbol()); //向饼图中添加数据 //检查交易品种 if(!For_all_symbols && deal.Symbol()!=Symbol()) continue; double profit=deal.Profit(); //获取交易利润 profit+=deal.Swap(); //库存费 profit+=deal.Commission(); //手续费 store+=profit; //累积利润 Data.Add(new CArrayDouble); //将新的元素添加到数组 ((CArrayDouble *)Data.At(Data.Total()-1)).Add(profit); //以及数据 ((CArrayDouble *)Data.At(Data.Total()-1)).Add(deal.Type()); } } //计算初始入金 double initial_deposit=(balance-store); for(int i=0;i<Data.Total();i++) //遍历交易 { //计算余额 initial_deposit+=((CArrayDouble *)Data.At(i)).At(0); ChartData.Add(initial_deposit); //存入数组中 } }
首先，我们来看存储数据的方法。标准库会提供数据结构类，它们能让您避免使用数组。我们需要一个二维数组，其中会存储有关利润及历史交易类型的数据。但“标准库”不会提供组织二维数组的显式类，却有 CArrayDouble （双精度数据类型数组）和 CArrayObj 类（指向 CObject 类实例及其继承子类的指针动态数组）。即，我们可以创建一个双精度数组的数组，而这正是我们所做的。
当然， ((CArrayDouble *) Data.At (Data.Total () - 1 )).Add (profit) 之类的语句没有 data [i] [j] = profit 简洁，但这只是表面现象。毕竟，在只是简单地声明一个数组、且未使用标准库类的情况下，我们就不能享用诸如内置内存管理器、插入一个不同的数组的能力、对比数组、查找项目之类的好处。因此，存储器组织类的使用让我们无需控制数组的溢出，并为我们提供了许多有用的工具。
CArray 类的 Total() 方法（参见图 1）会返回数组中的元素数量，Add() 方法会添加它们，而 At() 方法则返回元素。
因为我们决定构建一个饼图来显示交易品种的交易量，所以我们需要收集必要的数据。
我们会编写一个辅类以收集此数据：
//+------------------------------------------------------------------+ ///饼图表类 //+------------------------------------------------------------------+ class PieData { protected: ///每个交易品种的交易笔数 CArrayInt val; ///交易品种 CArrayString symb; public: ///删除数据 bool Shutdown() { bool res=true; res&=val.Shutdown(); res&=symb.Shutdown(); return res; } ///在数组中查找字符串 int Search(string str) { //检查所有数组元素 for(int i=0;i<symb.Total();i++) if(symb.At(i)==str) return i; return -1; } ///添加新数据 void Add(string str) { int symb_pos=Search(str);//确定数组中交易品种的位置 if(symb_pos>-1) val.Update(symb_pos,val.At(symb_pos)+1);//更新交易数据 else //如果没有找到 { symb.Add(str); //添加 val.Add(1); } } int Total() const {return symb.Total();} int Get_val(int pos) const {return val.At(pos);} string Get_symb(int pos) const {return symb.At(pos);} };
标准库类也并不能够始终为我们提供必要的工作方法。本例中，CArrayString 类的 Search() 方法就不适用，因为想要应用它，我们必须首先分拣数组，而这样又会违反数据结构。因此我们必须得编写自己的方法。
交易特性的计算采用 Calculate() 方法实现：
//+------------------------------------------------------------------+ ///计算特征值 //+------------------------------------------------------------------+ void Board::Calculate() { //获取数据 GetData(); //置零 gross_profit=0; gross_loss=0; net_profit=0; profit_factor=0; expected_payoff=0; absolute_drawdown=0; maximal_drawdown_pp=0; maximal_drawdown=0; relative_drawdown=0; relative_drawdown_pp=0; total=Data.Total(); long_positions=0; long_positions_won=0; short_positions=0; short_positions_won=0; profit_trades=0; profit_trades_pp=0; loss_trades=0; loss_trades_pp=0; largest_profit_trade=0; largest_loss_trade=0; average_profit_trade=0; average_loss_trade=0; maximum_consecutive_wins=0; maximum_consecutive_wins_usd=0; maximum_consecutive_losses=0; maximum_consecutive_losses_usd=0; maximum_consecutive_profit=0; maximum_consecutive_profit_usd=0; maximum_consecutive_loss=0; maximum_consecutive_loss_usd=0; average_consecutive_wins=0; average_consecutive_losses=0; if(total==0) return; //如果没有成交记录，函数返回 double max_peak=0,min_peak=0,tmp_balance=0; int max_peak_pos=0,min_peak_pos=0; int max_cons_wins=0,max_cons_losses=0; double max_cons_wins_usd=0,max_cons_losses_usd=0; int avg_win=0,avg_loss=0,avg_win_cnt=0,avg_loss_cnt=0; for(int i=0; i<total; i++) { double profit=((CArrayDouble *)Data.At(i)).At(0); //获取利润 int deal_type=((CArrayDouble *)Data.At(i)).At(1); //以及成交类型 switch(deal_type) //检查成交类型 { //计算买入持仓和卖出持仓的数量 case DEAL_TYPE_BUY: {long_positions++; if(profit>=0) long_positions_won++; break;} case DEAL_TYPE_SELL: {short_positions++; if(profit>=0) short_positions_won++; break;} } if(profit>=0)//如果是获利的 { gross_profit+=profit; //净利润 profit_trades++; //获利交易的数量 //最大获利交易和最大连续获利笔数 if(profit>largest_profit_trade) largest_profit_trade=profit; if(maximum_consecutive_losses<max_cons_losses || (maximum_consecutive_losses==max_cons_losses && maximum_consecutive_losses_usd>max_cons_losses_usd)) { maximum_consecutive_losses=max_cons_losses; maximum_consecutive_losses_usd=max_cons_losses_usd; } if(maximum_consecutive_loss_usd>max_cons_losses_usd || (maximum_consecutive_loss_usd==max_cons_losses_usd && maximum_consecutive_losses<max_cons_losses)) { maximum_consecutive_loss=max_cons_losses; maximum_consecutive_loss_usd=max_cons_losses_usd; } //均笔获利 if(max_cons_losses>0) {avg_loss+=max_cons_losses; avg_loss_cnt++;} max_cons_losses=0; max_cons_losses_usd=0; max_cons_wins++; max_cons_wins_usd+=profit; } else //亏损的交易 { gross_loss-=profit; //累积利润 loss_trades++; //亏损的成交笔数 //最大亏损交易和最大连续亏损笔数 if(profit<largest_loss_trade) largest_loss_trade=profit; if(maximum_consecutive_wins<max_cons_wins || (maximum_consecutive_wins==max_cons_wins && maximum_consecutive_wins_usd<max_cons_wins_usd)) { maximum_consecutive_wins=max_cons_wins; maximum_consecutive_wins_usd=max_cons_wins_usd; } if(maximum_consecutive_profit_usd<max_cons_wins_usd || (maximum_consecutive_profit_usd==max_cons_wins_usd && maximum_consecutive_profit<max_cons_wins)) { maximum_consecutive_profit=max_cons_wins; maximum_consecutive_profit_usd=max_cons_wins_usd; } //均笔亏损 if(max_cons_wins>0) {avg_win+=max_cons_wins; avg_win_cnt++;} max_cons_wins=0; max_cons_wins_usd=0; max_cons_losses++; max_cons_losses_usd+=profit; } tmp_balance+=profit; //计算绝对亏损 if(tmp_balance>max_peak) {max_peak=tmp_balance; max_peak_pos=i;} if(tmp_balance<min_peak) {min_peak=tmp_balance; min_peak_pos=i;} if((max_peak-min_peak)>maximal_drawdown && min_peak_pos>max_peak_pos) maximal_drawdown=max_peak-min_peak; } //计算最大跌幅 double min_peak_rel=max_peak; tmp_balance=0; for(int i=max_peak_pos;i<total;i++) { double profit=((CArrayDouble *)Data.At(i)).At(0); tmp_balance+=profit; if(tmp_balance<min_peak_rel) min_peak_rel=tmp_balance; } //计算相对跌幅 relative_drawdown=max_peak-min_peak_rel; //净利润 net_profit=gross_profit-gross_loss; //利润因子 profit_factor=(gross_loss!=0) ? gross_profit/gross_loss : gross_profit; //期望回报 expected_payoff=net_profit/total; double initial_deposit=AccountInfoDouble(ACCOUNT_BALANCE)-net_profit; absolute_drawdown=MathAbs(min_peak); //跌幅 maximal_drawdown_pp=(initial_deposit!=0) ?(maximal_drawdown/initial_deposit)*100.0 : 0; relative_drawdown_pp=((max_peak+initial_deposit)!=0) ?(relative_drawdown/(max_peak+initial_deposit))*100.0 : 0; //盈利和亏损交易的占比 profit_trades_pp=((double)profit_trades/total)*100.0; loss_trades_pp=((double)loss_trades/total)*100.0; //每笔平均盈利和每笔平均亏损 average_profit_trade=(profit_trades>0) ? gross_profit/profit_trades : 0; average_loss_trade=(loss_trades>0) ? gross_loss/loss_trades : 0; //最大连续亏损 if(maximum_consecutive_losses<max_cons_losses || (maximum_consecutive_losses==max_cons_losses && maximum_consecutive_losses_usd>max_cons_losses_usd)) { maximum_consecutive_losses=max_cons_losses; maximum_consecutive_losses_usd=max_cons_losses_usd; } if(maximum_consecutive_loss_usd>max_cons_losses_usd || (maximum_consecutive_loss_usd==max_cons_losses_usd && maximum_consecutive_losses<max_cons_losses)) { maximum_consecutive_loss=max_cons_losses; maximum_consecutive_loss_usd=max_cons_losses_usd; } if(maximum_consecutive_wins<max_cons_wins || (maximum_consecutive_wins==max_cons_wins && maximum_consecutive_wins_usd<max_cons_wins_usd)) { maximum_consecutive_wins=max_cons_wins; maximum_consecutive_wins_usd=max_cons_wins_usd; } if(maximum_consecutive_profit_usd<max_cons_wins_usd || (maximum_consecutive_profit_usd==max_cons_wins_usd && maximum_consecutive_profit<max_cons_wins)) { maximum_consecutive_profit=max_cons_wins; maximum_consecutive_profit_usd=max_cons_wins_usd; } //平均亏损和盈利 if(max_cons_losses>0) {avg_loss+=max_cons_losses; avg_loss_cnt++;} if(max_cons_wins>0) {avg_win+=max_cons_wins; avg_win_cnt++;} average_consecutive_wins=(avg_win_cnt>0) ? round((double)avg_win/avg_win_cnt) : 0; average_consecutive_losses=(avg_loss_cnt>0) ? round((double)avg_loss/avg_loss_cnt) : 0; //获利的买入和卖出持仓数量 long_positions_won=(long_positions>0) ?((double)long_positions_won/long_positions)*100.0 : 0; short_positions_won=(short_positions>0) ?((double)short_positions_won/short_positions)*100.0 : 0; }
Google Chart API 允许开发人员即时创建各种类型的图解。Google Chart API 存储于指向 Google 网络服务器资源的链接 (URL)，如果接收到一个格式正确的链接 (URL)，就会以图像形式返回图解。
图解属性（颜色、标题、轴、图表上的点位等）均由此链接 (URL) 指定。生成的图像可存储于文件系统或数据库中。最令人高兴的是，Google Chart API 完全免费，无需创建账户或是经历注册流程。
GetChart() 方法会从 Google 接收图表并将其保存到磁盘：
#import "PNG_to_BMP.dll"//引入动态链接库函数，将png转换为bmp bool Convert_PNG(string src,string dst); #import #import "wininet.dll"//引入动态链接库函数，实现和网络相关的功能 int InternetAttemptConnect(int x); int InternetOpenW(string sAgent,int lAccessType, string sProxyName="",string sProxyBypass="", int lFlags=0); int InternetOpenUrlW(int hInternetSession,string sUrl, string sHeaders="",int lHeadersLength=0, int lFlags=0,int lContext=0); int InternetReadFile(int hFile,char &sBuffer[],int lNumBytesToRead, int &lNumberOfBytesRead[]); int InternetCloseHandle(int hInet); #import //+------------------------------------------------------------------+ ///创建余额图的函数 //+------------------------------------------------------------------+ void Board::GetChart(int X_size,int Y_size,string request,string file_name) { if(X_size<1 || Y_size<1) return; //太小 //尝试创建连接 int rv=InternetAttemptConnect(0); if(rv!=0) {Alert("Error in call of the InternetAttemptConnect()"); return;} //初始化结构体 int hInternetSession=InternetOpenW("Microsoft Internet Explorer", 0, "", "", 0); if(hInternetSession<=0) {Alert("Error in call of the InternetOpenW()"); return;} //发送请求 int hURL=InternetOpenUrlW(hInternetSession, request, "", 0, 0, 0); if(hURL<=0) Alert("Error in call of the InternetOpenUrlW()"); //记录结果的文件 CFileBin chart_file; //让我们创建它 chart_file.Open(file_name+".png",FILE_BIN|FILE_WRITE); int dwBytesRead[1]; //读取数据的数量 char readed[1000]; //数据 //读取请求后由服务器返回的数据 while(InternetReadFile(hURL,readed,1000,dwBytesRead)) { if(dwBytesRead[0]<=0) break; //若没有数据，退出 chart_file.WriteCharArray(readed,0,dwBytesRead[0]); //将数据写入文件 } InternetCloseHandle(hInternetSession);//关闭连接 chart_file.Close();//关闭文件 //****************************** //为转换设置文件路径 CString src; src.Assign(TerminalInfoString(TERMINAL_PATH)); src.Append("\MQL5\Files\\"+file_name+".png"); src.Replace("\\","\\\\"); CString dst; dst.Assign(TerminalInfoString(TERMINAL_PATH)); dst.Append("\MQL5\Images\\"+file_name+".bmp"); dst.Replace("\\","\\\\"); //转换文件 if(!Convert_PNG(src.Str(),dst.Str())) Alert("Error in call of the Convert_PNG()"); }
有关使用 API Windows 与 MQL5 在线工具的更多详情，请参阅《利用 WinInet.dll 通过 Internet 实现各终端间的数据交换》一文。于此我不再赘述。导入的函数 Convert_PNG() 是我编写的，目的是将 PNG 图像转换为 BMP。
此举完全必要，因为 Google Chart 会以 PNG 或 GIF 格式返回图表，但 "graphic label" 对象只接受 BMP 图像。PNG_to_BMP.dll 库函数所对应的代码，均载于档案 DLL_Sources.zip。
此函数还展示了几个利用标准库操作行与文件的示例。CString 类方法允许执行与字符串函数相同的操作。 CFile 类是 CFileBin 与 CFileTxt 类的基础。在它们的帮助下，我们可以分别生成阅读与记录的二进制与文本文件：方法与使用文件的函数类似。
最后，我们来讲讲 CreateGoogleRequest () 函数 - 它会由余额图上的数据创建查询：
//+------------------------------------------------------------------+ ///创建谷歌图表服务器请求的函数 //+------------------------------------------------------------------+ string Board::CreateGoogleRequest(int X_size,int Y_size,bool type) { if(X_size>1000) X_size=1000; //检查图表大小 if(Y_size>1000) Y_size=300; //确保不会太大 if(X_size<1) X_size=1; //或太小//s18> if(Y_size<1) Y_size=1; if(X_size*Y_size>300000) {X_size=1000; Y_size=300;}//并且适合该区域 CString res; //结果字符串 if(type) //创建余额图请求 { //准备请求体 res.Assign("http://chart.apis.google.com/chart?cht=lc&chs="); res.Append(IntegerToString(X_size)); res.Append("x"); res.Append(IntegerToString(Y_size)); res.Append("&chd=t:"); for(int i=0;i<ChartData.Total();i++) res.Append(DoubleToString(ChartData.At(i),2)+","); res.TrimRight(","); //数组排序 ChartData.Sort(); res.Append("&chxt=x,r&chxr=0,0,"); res.Append(IntegerToString(ChartData.Total())); res.Append("|1,"); res.Append(DoubleToString(ChartData.At(0),2)+","); res.Append(DoubleToString(ChartData.At(ChartData.Total()-1),2)); res.Append("&chg=10,10&chds="); res.Append(DoubleToString(ChartData.At(0),2)+","); res.Append(DoubleToString(ChartData.At(ChartData.Total()-1),2)); } else //创建饼图请求 { //准备请求体 res.Assign("http://chart.apis.google.com/chart?cht=p3&chs="); res.Append(IntegerToString(X_size)); res.Append("x"); res.Append(IntegerToString(Y_size)); res.Append("&chd=t:"); for(int i=0;i<pie_data.Total();i++) res.Append(IntegerToString(pie_data.Get_val(i))+","); res.TrimRight(","); res.Append("&chdl="); for(int i=0;i<pie_data.Total();i++) res.Append(pie_data.Get_symb(i)+"|"); res.TrimRight("|"); res.Append("&chco="); int cnt=0; for(int i=0;i<pie_data.Total();i++) { if(cnt>11) cnt=0; res.Append(colors[cnt]+"|"); cnt++; } res.TrimRight("|"); } return res.Str(); //返回结果 }
注意：余额图与饼图的要求已分别收集完毕。Append() 方法会向现有行的末尾添加另一行，而 TrimRight() 方法则允许您移除该行末尾显示的多余字符。
6. 最终汇编与测试
类已准备就绪，我们来测试一下。从 OnInit () 指标开始吧：
Board *tablo; //面板对象指针 int prev_x_size=0,prev_y_size=0,prev_deals=0; //+------------------------------------------------------------------+ //| 自定义指标初始化函数 | //+------------------------------------------------------------------+ int OnInit() { //--- 指标缓存映射 //设置指标简称 IndicatorSetString(INDICATOR_SHORTNAME,"IT"); //加载计时器 EventSetTimer(1); //创建对象实例 tablo=new Board; //以及界面 tablo.CreateInterface(); prev_deals=HistoryDealsTotal(); //交易数 //当前窗口大小 prev_x_size=ChartGetInteger(0,CHART_WIDTH_IN_PIXELS); prev_y_size=ChartGetInteger(0, CHART_HEIGHT_IN_PIXELS); //--- return(0); }
我们于此动态创建 Board 类实例，启动计时器，初始化辅变量。
我们马上置入OnDeinit()函数，并由此移除（自动调用析构函数的）对象，再令计时器停止：
void OnDeinit(const int reason) { EventKillTimer(); //停止计时器 delete table; //删除面板 }
OnCalculate() 函数会一个订单号一个订单号地监测新交易的流动性，下述情况下还会更新显示：
int OnCalculate(const int rates_total, const int prev_calculated, const datetime &time[], const double &open[], const double &high[], const double &low[], const double &close[], const long &tick_volume[], const long &volume[], const int &spread[]) { //--- //准备历史数据 HistorySelect(0,TimeCurrent()); int deals=HistoryDealsTotal(); //如果成交笔数变化则更新面板 if(deals!=prev_deals) tablo.Refresh(); prev_deals=deals; //--- 返回prev_calculated的值用于下一次调用 return(rates_total); }
OnTimer() 函数会监测窗口大小的变化，必要时可以自定义显示屏大小，如果订单号每秒少于一个，则亦监测 OnCalculate() 之类的交易。
void OnTimer() { int x_size=ChartGetInteger(0, CHART_WIDTH_IN_PIXELS); int y_size=ChartGetInteger(0, CHART_HEIGHT_IN_PIXELS); //如果窗口大小改变则更新面板 if(x_size!=prev_x_size || y_size!=prev_y_size) tablo.Refresh(); prev_x_size=x_size; prev_y_size=y_size; //如果成交笔数变化则更新面板 HistorySelect(0,TimeCurrent()); int deals=HistoryDealsTotal(); if(deals!=prev_deals) tablo.Refresh(); prev_deals=deals; }
编译并运行此指标：
图 3. 此表的最终视图
总结
亲爱的读者朋友，我希望您能通过阅读本文学到一些新东西。我努力在您面前展示这个作为“标准库”的奇妙工具的所有可能性，因为它会提供便利、速度以及优质性能。当然，您需要懂一点 OOP。
祝您好运！
先将 MQL5.rar 档案解压缩到终端文件夹，并允许使用 DLL。DLL_Sources.zip 档案文件中包含库 String_Metrics.dll PNG_to_BMP.dll 的源代码，它们都是我在一个已配 GDI 的 Borland C++ Builder 环境中编写的。
本社区仅针对特定人员开放
查看需注册登录并通过风险意识测评
5秒后跳转登录页面...
移动端课程
