MultiCharts编程-PowerLanguage-Arrow drawing画箭头

对于特定的行情趋势或反转点等其他情形，我们希望能够在图上有特别的标识，方便观看和判断。那么，在MultiCharts图表窗口中，使用绘图工具可以增加向上或向下的箭，而此功能也可以用策略程序来实现，本章则详细说明了程序实现画箭头的方法。

Arw_Delete
说明	删除图表上指定编号的箭头。删除成功返回0，如果指定编号无效则返回-2。
语法	Arw_Delete(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
范例	删除编号为3的箭头物件：    Value1=Arw_Delete(3);

Arw_GetActive
说明	返回目前选取的箭头物件的编号。返回-1为当前未选取任何箭头物件。
语法	Arw_GetActive
注意	*箭头编号是在箭头物件被创建时Arw_New对应的返回值。    *测试此关键字，不管当前箭头是否被选中，每根Bar都会运算，print值会随新Bar的到来而改变。
范例	将目前选取的箭头物件编号存入变量Value1：    If c > c[1] then    Value1=Arw_New_s(Date,Time_s,High,False);    Value2=Arw_GetActive;    Print(Value2,” “,time_s);

Arw_GetColor
说明	取得箭头物件的颜色（RGB色码或传统色码）。
语法	Arw_GetColor(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	数值——箭头颜色编码；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时Arw_New对应的返回值。
范例	取得编号为3的箭头物件的颜色值（RGB色码表示）：    Value1=Arw_GetColor(3);    取得编号为3的箭头物件的颜色值（传统色码表示）：    [LegacyColorValue=True];    Value1=Arw_GetColor(3);

Arw_GetDate
说明	取得箭头物件所在Bar的日期。    日期显示为YYYMMdd格式，YYY表示自1900至今的年份，MM表示月，dd表示日。
语法	Arw_GetDate(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	数值——箭头所在日期；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时Arw_New对应的返回值。
范例	取得编号为3的箭头物件所在的Bar的日期：    Value1=Arw_GetDate(3);

Arw_GetDirection
说明	取得箭头物件的方向（垂直位置）。
语法	Arw_GetDirection(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	True——向下箭头；    False——向上箭头或无效的物件编号。
注意	ObjectID是在箭头物件被创建时Arw_New对应的返回值。
范例	取得编号为3的箭头物件的方向，将返回值赋给变量DownArrow  ：    Variable:DownArrow(False);      DownArrow=Arw_GetDirection(3);

Arw_GetFirst
说明	取得指定条件下最先新增在图表上的箭头物件编号。
语法	Arw_GetFirst(Origin)
参数	Origin——数值表达式，指定箭头物件产生条件，范围为1~7：    1 — 目前公式所新增的箭头物件    2 — 非目前公式或使用者手动新增的箭头物件    3 — 任何公式或使用者手动新增的箭头物件    4 — 目前公式或使用者手动新增的箭头物件    5 — 非目前公式新增的箭头物件    6 — 任何公式新增的箭头物件    7 — 使用者手动新增的箭头物件
返回	-2——无效的箭头物件编号。
注意	如果最先新增的箭头物件被删除，则下一个箭头物件会成为最先新增的箭头物件。
范例	将目前公式最先新增的箭头物件的编号赋值给变量Value1：    Value1=Arw_GetFirst(1);

Arw_GetNext
说明	取得在特定箭头物件之后新增的箭头物价编号。
语法	Arw_GetNext(ObjectID, Origin)
参数	ObjectID——数值表达式，箭头物件的编号。    Origin——数值表达式，指定箭头物件产生条件，范围为1~7：    1 — 目前公式所新增的箭头物件    2 — 非目前公式或使用者手动新增的箭头物件    3 — 任何公式或使用者手动新增的箭头物件    4 — 目前公式或使用者手动新增的箭头物件    5 — 非目前公式新增的箭头物件    6 — 任何公式新增的箭头物件    7 — 使用者手动新增的箭头物件
返回	-2——无效的箭头物件编号。
范例	将在3号箭头物件之后，由目前公式所新增的箭头物件编号存入变量Value1：    Value1=Arw_GetNext(3,1);

Arw_GetSize
说明	取得箭头物件的大小。
语法	Arw_GetSize(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	-2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时Arw_New对应的返回值。
范例	取得编号为3的箭头物件的大小：    Value1=Arw_GetSize(3);

Arw_GetStyle
说明	取得箭头物件的样式。
语法	Arw_GetStyle(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	-2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时Arw_New对应的返回值。
范例	取得编号为3的箭头物件的类型：    Value1=Arw_GetStyle(3);

Arw_GetText
说明	取得箭头物件的说明文字。
语法	Arw_GetText(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	说明文字——字符串类型；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时Arw_New对应的返回值。
范例	Arw_GetText(3) 返回编号为3的箭头物件的说明文字。

Arw_GetTextAttribute
说明	取得箭头物件说明文字的属性。可以取得外框，粗体，斜体，删除线，底线的属性设定。
语法	Arw_GetTextAttribute(ObjectID, Attribute)
参数	ObjectID——数值表达式，箭头物件的编号。    Attribute——数值表达式，属性编号：    0 — 外框    1 — 粗体    2 — 斜体    3 — 删除线    4 — 底线
返回	True——启用    False——取消
注意	ObjectID是在箭头物件被创建时Arw_New对应的返回值。
范例	取得编号为3的箭头物件的说明文字是否为粗体的属性设定状态：    Variable:ArwTxtBold(False);      ArwTxtBold=Arw_GetTextAttribute(3,1);

Arw_GetTextBGColor
说明	取得箭头物件说明文字的底色。
语法	Arw_GetTextBGColor(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	-2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时Arw_New对应的返回值。
范例	取得箭头物件说明文字的底色（RGB色码表示）：    Value1=Arw_GetTextBGColor(3);    取得箭头物件说明文字的底色（传统色码表示）：    [LegacyColorValue=True];    Value1=Arw_GetTextBGColor(3);

Arw_GetTextColor
说明	取得箭头物件说明文字的颜色。
语法	Arw_GetTextColor(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	-2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	取得箭头物件说明文字的颜色（RGB色码表示）：    Value1=Arw_GetTextColor(3);    取得箭头物件说明文字的颜色（传统色码表示）：    [LegacyColorValue=True];    Value1=Arw_GetTextColor(3);

Arw_GetTextFontName
说明	取得箭头物件说明文字的字型。
语法	Arw_GetTextFontName(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	说明文字的字型——字符串类型；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	Arw_GetTextFontName(3) 返回值为编号为3的箭头物件的说明文字的字型。

Arw_GetTextSize
说明	取得箭头物件说明文字的字型大小。
语法	Arw_GetTextSize(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	-2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	取得编号为3的箭头物件说明文字的字型大小：    Value1=Arw_GetTextSize(3);

Arw_GetTime
说明	取得箭头物件所在Bar的时间。    时间格式为HHmm，24小时制。1300=1：00pm
语法	Arw_GetTime(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	-2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	取得编号为3的箭头物件所在Bar的时间，并存入变量Value1：    Value1=Arw_GetTime(3);

Arw_GetTime_s
说明	取得箭头物件所在Bar的时间。    时间格式为HHmmss，24小时制。130000=1:00:00pm
语法	Arw_GetTime_s(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	-2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New_s对应的返回值。
范例	取得编号为3的箭头物件所在Bar的时间，并存入变量Value1：    Value1=Arw_GetTime_s(3);

Arw_GetVal
说明	取得箭头物件的价格（垂直位置）。
语法	Arw_GetVal(ObjectID)
参数	ObjectID——数值表达式，箭头物件的编号。
返回	-2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	取得编号为3的箭头物件的价格，并存入变量Value1：    Value1=Arw_GetVal(3);

Arw_New
说明	在图表上指定位置标示一个向上或向下的箭头物件。
语法	Arw_New(BarDate,BarTime,PriceValue,Direction)
参数	BarDate——数值表达式，显示箭头的Bar日期；日期格式为YYYMMdd    BarTime——数值表达式，显示箭头的Bar时间；时间格式为HHmm    PriceValue——数值表达式，显示箭头的价格（垂直）位置    Direction——逻辑表达式，True为向下箭头，False为向上箭头
返回	数值——箭头物件的编号ObjectID
范例	当连续三根Bar的开盘价都持续升高，则在Bar最高价的位置显示一个向上的箭头：    If Open>Open[1] And Open[1]>Open[2]  Then    Value1=Arw_New(Date,Time,High,False);

Arw_New_s
说明	在图表上指定位置标示一个向上或向下的箭头物件。
语法	Arw_New_s(BarDate,BarTime_s,PriceValue,Direction)
参数	BarDate——数值表达式，显示箭头的Bar日期；日期格式为YYYMMdd    BarTime_s——数值表达式，显示箭头的Bar时间；时间格式为HHmmss    PriceValue——数值表达式，显示箭头的价格（垂直）位置    Direction——逻辑表达式，true为向下箭头，false为向上箭头
返回	数值——箭头物件的编号ObjectID
范例	当连续三根Bar的开盘价都持续升高，则在Bar最高价的位置显示一个向上的箭头：    If Open>Open[1] And Open[1]>Open[2]  Then    Value1= Arw_New_s(Date,Time_s,High,False);

Arw_New_self
说明	在指标的子图上指定位置标示一个箭头物件。
语法	Arw_New_self(BarDate,BarTime,PriceValue,Direction)
参数	BarDate——数值表达式，显示箭头的Bar日期；日期格式为YYYMMdd    BarTime——数值表达式，显示箭头的Bar时间；时间格式为HHmm    PriceValue——数值表达式，显示箭头的价格（垂直）位置    Direction——逻辑表达式，true为向下箭头，false为向上箭头
返回	数值——箭头物件的编号ObjectID
注意	测试写在信号中，箭头会画在主图上。写在指标中，需要设定以子图数据计算，才可以画在子图上。
范例	当连续三根Bar的开盘价都持续升高，则在指标子图上最高价的位置显示一个向上的箭头：    If Open>Open[1] And Open[1]>Open[2]  Then    Value1= Arw_New_self(Date,Time,High,False);

Arw_New_self_s
说明	在指标的子图上指定位置标示一个箭头物件。
语法	Arw_New_self_s(BarDate,BarTime_s,PriceValue,Direction)
参数	BarDate——数值表达式，显示箭头的Bar日期；日期格式为YYYMMdd    BarTime_s——数值表达式，显示箭头的Bar时间；时间格式为HHmmss    PriceValue——数值表达式，显示箭头的价格（垂直）位置    Direction——逻辑表达式，true为向下箭头，false为向上箭头
注意	测试写在信号中，箭头会画在主图上。写在指标中，需要设定以子图数据计算，才可以画在子图上。
返回	数值——箭头物件的编号ObjectID
范例	当连续三根Bar的开盘价都持续升高，则在指标子图上最高价的位置显示一个向上的箭头：    If Open>Open[1] And Open[1]>Open[2]  Then    Value1= Arw_New_self_s(Date,Time_s,High,False);

Arw_SetColor
说明	设定箭头物件的颜色（RGB色码或传统色码）。
语法	Arw_SetColor(ObjectID, ArrowColor)
参数	ObjectID——数值表达式，箭头物件的编号    ArrowColor——数值表达式，箭头颜色。颜色可以是RGB色码或传统色码或者17种基本颜色。
返回	0——设定成功；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	将编号为3的箭头物件的颜色设定为蓝色（基本颜色参数）：    Value1=Arw_SetColor(3,Blue);    将编号为3的箭头物件的颜色设定为橙色（RGB色码参数）：    Value1=Arw_SetColor(3,2138336);    将编号为3的箭头物件的颜色设为绿色（传统色码参数）：    [LegacyColorValue=True];    Value1=Arw_SetColor(3,4);

Arw_SetLocation
说明	设定箭头物件的位置
语法	Arw_SetLocation(ObjectID,BarDate,BarTime,PriceValue)
参数	ObjectID——数值表达式，箭头物件的编号    BarDate——数值表达式，显示箭头的BAR日期；日期格式为YYYMMdd    BarTime——数值表达式，显示箭头的BAR时间；时间格式为HHmm    PriceValue——数值表达式，显示箭头的价格（垂直）位置
返回	0——设定成功；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	将编号为3的箭头移至目前BAR的最高价：    Value1=Arw_SetLocation(3,Date,Time,High);

Arw_SetLocation_s
说明	设定箭头物件的位置
语法	Arw_SetLocation_s(ObjectID,BarDate,BarTime_s,PriceValue)
参数	ObjectID——数值表达式，箭头物件的编号    BarDate——数值表达式，显示箭头的Bar日期；日期格式为YYYMMdd    BarTime_s——数值表达式，显示箭头的Bar时间；时间格式为HHmmss    PriceValue——数值表达式，显示箭头的价格（垂直）位置
返回	0——设定成功；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New_s对应的返回值。
范例	将编号为3的箭头移至目前Bar的最高价：    Value1=Arw_SetLocation_s(3,Date,Time_s,High);

Arw_SetSize
说明	设定箭头物件的大小。
语法	Arw_SetSize(ObjectID, ArrowSize)
参数	ObjectID——数值表达式，箭头物件的编号。    ArrowSize——数值表达式，要设定的箭头大小。
返回	0——设定成功；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	设定3号箭头的物件的大小为10：    Value1=Arw_SetSize(3,10);

Arw_SetStyle
说明	设定箭头物件的样式。
语法	Arw_GetStyle(ObjectID,ArrowStyle)
参数	ObjectID——数值表达式，箭头物件的编号。    ArrowStyle——数值表达式，代表箭头样式的数值，范围为0~13；可参考设置绘图中设置样式。
返回	0——设定成功    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	设定3号箭头物件的样式为5：    Value1=Arw_SetStyle(3,5);

Arw_SetText
说明	设定箭头物件的说明文字。
语法	Arw_SetText(ObjectID, ”Text”)
参数	ObjectID——数值表达式，箭头物件的编号。    Text——字符串表达式，箭头的说明文字。
返回	0——设定成功；    -2——无效的箭头物件编号。
范例	在3号箭头物件加上说明文字 "My Arrow" ：    Value1=Arw_SetText(3,"My Arrow");    替换3号箭头物件的说明文字为 "New Text"：    Value1=Arw_SetText(3,"New Text");

Arw_SetTextAttribute
说明	设定箭头物件说明文字的属性。可以设定外框，粗体，斜体，删除线，底线。
语法	Arw_SetTextAttribute(ObjectID,Attribute,LogicalExpression)
参数	ObjectID——数值表达式，箭头物件的编号。    Attribute——数值表达式，属性编号。    0 — 外框    1 — 粗体    2 — 斜体    3 — 删除线    4 — 底线    LogicalExpression——逻辑表达式，True 启用，False 取消
返回	0——设定成功；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	将3号箭头物件的说明文字设定为粗体：    Value1= Arw_SetTextAttribute(3,1,True);

Arw_SetTextBGColor
说明	设定箭头物件说明文字的底色。
语法	Arw_SetTextBGColor(ObjectID,TextBGColor)
参数	ObjectID——数值表达式，箭头物件的编号。    TextBGColor——数值表达式，箭头说明文字的背景颜色。颜色可以是RGB色码或传统色码或者17种基本颜色。
返回	0——设定成功；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	设定3号箭头物件的说明文字底色为蓝色（基本颜色参数）：    Value1=Arw_SetTextBGColor(3,Blue);    设定3号箭头物件的说明文字底色为橙色（RGB色码参数）：    Value1=Arw_SetTextBGColor(3,2138336);    设定3号箭头物件的说明文字底色为绿色（传统色码参数）：    [LegacyColorValue=True];    Value1=Arw_SetTextBGColor(3,4);

Arw_SetTextColor
说明	设定箭头物件说明文字的颜色。
语法	Arw_SetTextColor(ObjectID, TextColor)
参数	ObjectID——数值表达式，箭头物件的编号。    TextColor——数值表达式，箭头说明文字颜色。颜色可以是RGB色码或传统色码或者17种基本颜色。
返回	0——设定成功；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	设定3号箭头物件的说明文字为蓝色（基本颜色参数）：    Value1=Arw_SetTextColor(3,Blue);    设定3号箭头物件的说明文字为橙色（RGB色码参数）：    Value1=Arw_SetTextColor(3,2138336);    设定3号箭头物件的说明文字为绿色（传统色码参数）：    [LegacyColorValue=True];    Value1=Arw_SetTextColor(3,4);

Arw_SetTextFontName
说明	设定箭头物件说明文字的字型。    字型文件夹中的任意字型都可以使用。在windows  XP系统中可以在控制面板中进入字型文件夹。
语法	Arw_SetTextFontName(ObjectID, ”FontName”)
参数	ObjectID——数值表达式，箭头物件的编号。    FontName——字符串表达式，windows字型文件夹内的字型名称。
返回	0——设定成功；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	设定3号箭头物件的字型为Verdana：    Value1=Arw_SetTextFontName(3,"Verdana");

Arw_SetTextSize
说明	设定箭头物件说明文字的字型大小。
语法	Arw_SetTextSize(ObjectID,FontSize)
参数	ObjectID——数值表达式，箭头物件的编号。    FontSize——数值表达式，箭头说明文字的字型大小。
返回	0——设定成功；    -2——无效的箭头物件编号。
注意	ObjectID是在箭头物件被创建时 Arw_New对应的返回值。
范例	设定编号为3的箭头物件说明文字的字型大小为16：    Value1=Arw_SetTextSize(3,16);

MC_Arw_GetActive
说明	取得当前被选中的箭头物件的编号。
语法	MC_Arw_GetActive
返回	-1——当前未选取任何箭头物件。
范例	取得当前被选中的箭头物件的编号，赋值给变量Value1：    Value1 = MC_Arw_GetActive;