5.15 Object functions物件函数
关于当前图表有关的图表物件的一组函数。
5.15.1 ObjectCreate建立目标
bool ObjectCreate(string name，int type，int window，datetime timel，doublepricel，void time2，void price2，void time3，void price3)
物件创建的指定名称、类型和最初坐标的指定窗口。
计数坐标与物件的关联可以是从1到3物件类型。如果函数成功，返回值将是TRUE;否则，将是FALSEo
要获得详细的错误信息，信查看GetLastError()函数。
OBJ_LABEL类型的物件忽略坐标。使用ObjectSet()设定OBJPROP_XDISTANCE和OBJPROP_YDISTANCE属性。
注解:子窗口图表(如果子窗口带有指标)编号从1开始。主窗口的存在的索引为零。
必须通过的坐标:时间和价格。例如，OBJ_VLINE指物件需要时间，但必须通过价格(任何值)。
【参量】
Name—物件唯一名称。
Type—物件类型。它可以是物件类型列举的任意值。
Window—窗口将增加的索引。窗口索引必须大于或等于零，并且小于WindowsTotal()。
time 1—第一点的时间部分。
pricel—第一点的值部分。
time2—第二点的时间部分。
price2—第二点的值部分。
time3—第三点的时间部分。
price3—第三点的值部分。
【示例】
5.15.2 ObjectDelete删除目标
bool ObjectDelete(string name
删除物件已有的指定名称。如果函数成功，返回值将是TRUE，否则;将是FALSE。要获得详细的错误信息，清查看GetLastError()函数。
【参量】
Name—被删除的物件名称。
【示例】
ObjectDelete”text_object"（）;
5.15.3 ObjectDescription目标描述
string ObjectDescription(string name)
返回物件描述。对于OBJ_TEXT和OBJ_LABEL类型物件，这些物件文本将返回。
要获得详细的错误信息，请查看GetLastError()函数。
参见ObjectSetText)函数。
【参量】
Name—物件名称。
【示例】
5.15.4 ObjectFind查找目标
int ObjectFin<I(string name)
查找指定的物件名称。窗口的索引包含所找到的物件。如果它失败，返回值将是一1。子窗口图表(如果子窗口带有指标)编号从1开始。主窗口的索引为零。要获得详细的错误信息，请查看GetLastError()函数。
【参量】
Name—查找的物件名称。
【示例】
if( ObjectFind(”line_object2")!=win_idx) return(0);
5.15.5 ObjectGet目标属性
double ObjectGet( string name，int index)
函数返回指定物件的属性。检查错误，请查看GetLastError()函数。
参见ObjectSet()函数。
【参量】
Name—物件名称。
Index—物件属性索引。它可以是物件属性列举值的任意值。
【示例】
color oldColor=ObjectGet(”hlinel2",OBJPROP COLOR);
5.15.6 ObjectGetFiboDescription斐波纳契描述
string ObjectGetFiboDescription( string name，int index)
返回对斐波纳契物件的平实描述。相当数量的斐波纳契水平取决于物件类型。最大斐波纳契水平为32要获得详细的错误信息，请查看GetLas-tE rror)函数。
参见ObjectSetFiboDescription ( ) 函数。
【参量】
Name——斐波纳契物件名称
Index——斐波纳契索引水平(0-31)）
【示例】
5.15.7 ObjectGetShiftByValue返回指定物件的值
int ObjectGetShiftByValue( string name，double value)
计算并返回索引柱(移动当前相关的柱)给出的值。索引柱由第一和第二坐标应用线性方程计算。该函数适用于趋势线和相似的物件。要获得详细的错误信息，请查看GetLastError()函数。
参见ObjectGetValueByShift()函数。
【参量】
Name—物件名称。
Value—价格值。
【示例】
int shift=ObjectGetShiftByValue(”MyTrendLineJHJ123"，1.34);
5.15.8 ObjectGetValueByShift返回指定物件索引
double ObjectGetValueByShift( string name，int shift)
计算并返回指定柱的值(转移当前相关的柱)。索引柱由第一和第二坐标应用线性方程计算。该函数适用于趋势线和相似的物件。要获得详细的错误信息，请查看Getl,astError()函数。
参见ObjectGetShiftByValue)I}1数。
【参量】
Name—物件名称。
Shift—柱索引。
【示例】
double price=ObjectGeV' alueByShift(”MyTrendLine#123"，11);
5.15.9 ObjectMove移动目标
boot ObjectMove( string name，int point，datetime iimel，double pricel)
在图中移动一个物件坐标。根据类型的不同，物件有一个到三个坐标。如果函数成功，返回值将是TRUE;否则，将是FALSE。要获得详细的错误信息，请查看Getl.astError()函数。物件坐标的开始数字必须是零。
【参量】
Name—物件名称。
Point—坐标索引(0一2)。
timel—新时间值。
pricel—新值。
【示例】
ObjectMove(”M yTrend"，1 , D'2005. 02. 25 12 ; 30'，1.2345);
5.15.10 ObjectName目标名
string ObjectName( int index)
在物件列表中，用它的索引函数返回物件名称。要获得详细的错误信息，请查看GetLastError()函数。
【参量】
Index在物件列表中的物件索引。物件索引必须超过或等于零，并且小于ObjectsTotal)。
【示例】
in( obj_ total=Objects'1'otal);
strm只namf";
for(int i=0;i<obj_lotal;i++)
{
name=ObjectName( i);
Print( i,”物件名称为”+ name);
5.15.11 ObjectsDeleteAll删除所有目标
int ObjectsDeleteAll( void window，void type)
在图表的子窗口删除全部类型物件。函数返回删除物件数。要获得详细的错误信息，请查看GetLastError)函数。
注解:子窗口图表(如果子窗口带有指标)编号从I开始。主窗口存在的索引为零。如果窗口索引错误或值为一1，物件会从现有的图表中删除。
如果类型值等于一1或这个参量是错误的，在子窗口的全部指定物件将被删除。
【参最】
Window—选择参量。物件的索引窗口将被删除。必须大于或等于一1 ( EMPTY为默认值)，并且小于W indowsTotal)。
Type—选择参量。被删除的物件类型。它可以是任意列举值的物件
类型或EMPTY常数删除所有物件类型。
【示例】
ObjectsDeleteAll(2,OBJ_HLINE); //从第二子窗口移除全部水平线。
ObjectsDeleteAll( 2 ) ;//从第二子窗口移除全部物件。
ObjectsDeleteAll( ) ;//从图表中移除全部物件。
5.15.12 ObjectSet改变目标属性
boot ObjectSet( string name，int index，double value)
改变指定物件属性的值。如果函数成功，返回值将是TRUE;否则，将是FALSE。要获得详细的错误信息，请查看GetLastError)函数。
参见ObjectGet)函数。
【参量】
Name—物件名称。
Index—物件索引值。它可以是列举的任意物件属性值。
Value—新的属性值。
【示例】
//moving the first word to the last bar time
ObjectSet(”MyTrend"，OBJPROP_TIME1 ,Time}0]);
//setting the .second fibo level
Ob)eetSBt(”M v FI60"，OBJPROP_FIRSTLEVEI.+I，I. 234);
//setting object visibility. object will he shown only on 15 minute and 1 hour charts
ObjectSet(’‘MyObject"，OBJPROP_TIM EFRA MES, OBJ_PERIOD_M 15 I OBJ_PERIOD_II1)
5.15.13 ObjectSetFiboDescription改变目标斐波纳契指标
boot ObjectSetFiboDescription(string name，int index，string text)
分配一个新的描述到斐波纳契物件的水平。相当数量的斐波纳契水平取决于物件类型。最大斐波纳契水平是犯要获得详细的错误信息，请查看GetLastError)函数。
【参量】
Name——物件名称。
Index——斐波纳契索引水平(0 -3I ) 。
【示例】
ObjectSetFi boDescription”MyFiboObjeet0 ,z，”Second line"
5.15.14 ObjectSetText改变目标说明
boot ObjectSetText(string name,string text，int font_size，void font，void text_color)
改变物件描述。对于OBJ_TEXT和OBJ_LABEI物件的描述作为图表文本显示。如果函数成功，返回的值将是TRUE;否则，将是FALSE。要获得详细的错误信息，请查看GetLastError( )函数。
只有字体大小、字体名称和文本颜色参量使用为font_size , font_name和text_ colo:物件)若为其他类型物件，这些参量被忽略。
参见ObjectDescription)函数
【参量】
Name—物件名称。
Text—描述物件文本。
font_ size—字体大小点数。
Font—字体名称。
text_ color—文本颜色。
【示例】
ObjectSetText”text_object"，”Hello world!”，10.”Times New Roman"，Green)
5.15.15 ObjectsTotal返回目标总量
int ObjectsTotal(void type)
在图表中返回指定物件类型总量。
【参量】
Type—选择参量。将计数的物件类型它可以是物件类型列举的任意值或EMPTY常数计算全部类型物件。
【示例】
5.15.16 ObjectType返回目标类型
int Objectl'ype ( string name )
函数返回物件类型值。要获得详细的错误信息，请查看GetLastError ( )函数。
【参量】
Name—物件名称。
【示例】
if( Ohject'1'ype(”line_object2")!=OBJ_HLINE) return(0);