ChartNavigate

通过指定的关系柱完成指定图表到图表中的指定位置的转换。

bool  ChartNavigate(

   long                  chart_id,     // 图表 ID

   ENUM_CHART_POSITION   position,     // 位置

   int                   shift=0       // 移动值

   );

参量

chart_id

[in] 图表 ID. 0 意味着当前图表。

position

[in] 完成转换的图表位置。可以是ENUM_CHART_POSITION值中的一个。

shift=0

[in] 转换图表的柱数。正值意味着向右移动（图表末端），负值意味着左移（到图表起点）。0值用来控制图表的起止。

返回值

若成功，返回true，否则返回false。

示例：

//+------------------------------------------------------------------+

//| 脚本程序起始函数                                                   |

//+------------------------------------------------------------------+

void OnStart()

  {

//--- 获得当前图表的句柄

   long handle=ChartID();

   string comm="";

   if(handle>0) // 如果成功，另外设置图表

     {

      //--- 禁止自动滚动

      ChartSetInteger(handle,CHART_AUTOSCROLL,false);

      //--- 设置从右图表边界转移

      ChartSetInteger(handle,CHART_SHIFT,true);

      //--- 绘制蜡烛图

      ChartSetInteger(handle,CHART_MODE,CHART_CANDLES);

      //--- 设置跳动量的显示模式

      ChartSetInteger(handle,CHART_SHOW_VOLUMES,CHART_VOLUME_TICK);



      //--- 在Comment()准备输出文本 

      comm="Scroll 10 bars to the right of the history start";

      //--- 显示注释

      Comment(comm);

      //--- 滚动10柱到历史记录开始的右侧

      ChartNavigate(handle,CHART_BEGIN,10);

      //--- 设置图表上第一柱显示的数量（类似时间帧的编号）

      long first_bar=ChartGetInteger(0,CHART_FIRST_VISIBLE_BAR,0);

      //--- 添加换行符

      comm=comm+"\r\n";

      //--- 添加到注释

      comm=comm+"The first bar on the chart is number "+IntegerToString(first_bar)+"\r\n";

      //--- 显示注释

      Comment(comm);

      //--- 等待5秒查看图表如何移动

      Sleep(5000);



      //--- 添加到注释文本

      comm=comm+"\r\n"+"Scroll 10 bars to the left of the right chart border";

      Comment(comm);

      //--- 滚动10柱到右图表边界的左侧

      ChartNavigate(handle,CHART_END,-10);

      //--- 获得图表上第一注显示的数量（类似时间帧的编号）

      first_bar=ChartGetInteger(0,CHART_FIRST_VISIBLE_BAR,0);

      comm=comm+"\r\n";

      comm=comm+"The first bar on the chart is number "+IntegerToString(first_bar)+"\r\n";

      Comment(comm);

      //--- 等待5秒查看图表如何移动

      Sleep(5000);



      //--- 图表滚动的新模块

      comm=comm+"\r\n"+"Scroll 300 bars to the right of the history start";

      Comment(comm);

      //--- 滚动300柱到历史记录开始的右侧

      ChartNavigate(handle,CHART_BEGIN,300);

      first_bar=ChartGetInteger(0,CHART_FIRST_VISIBLE_BAR,0);

      comm=comm+"\r\n";

      comm=comm+"The first bar on the chart is number "+IntegerToString(first_bar)+"\r\n";

      Comment(comm);

      //--- 等待5秒查看图表如何移动

      Sleep(5000);



      //--- 图表滚动的新模块

      comm=comm+"\r\n"+"Scroll 300 bars to the left of the right chart border";

      Comment(comm);

      //--- 滚动300柱到右图表边界的左侧

      ChartNavigate(handle,CHART_END,-300);

      first_bar=ChartGetInteger(0,CHART_FIRST_VISIBLE_BAR,0);

      comm=comm+"\r\n";

      comm=comm+"The first bar on the chart is number "+IntegerToString(first_bar)+"\r\n";

      Comment(comm);

     }

  }