ObjectSetString

此函数用于设置相应对象属性的值。该对象属性必须是字符串类型。该函数有两种变体。

设置属性值，不带修饰符：

bool  ObjectSetString(
   long     chart_id,        // chart identifier
   string   object_name,     // object name
   int      prop_id,         // property
   string   prop_value       // value
   );

设置表示修饰符的属性值：

bool  ObjectSetString(
   long     chart_id,        // chart identifier
   string   object_name,     // object name
   int      prop_id,         // property
   int      prop_modifier,   // modifier
   string   prop_value       // value
   );

参数

chart_id

[输入] 图表标识符。0表示当前图表。

object_name

[输入] 对象名称。

prop_id

[输入] 对象属性的ID。ENUM_OBJECT_PROPERTY_STRING枚举中的值之一可以作为该属性的值。

prop_modifier

[输入] 指定属性的修饰符。它表示斐波那契工具和图形对象Andrew’s pitchfork中的层级编号。层级编号从零开始。

prop_value

[输入] 属性的值。

返回值

只有当更改图形对象属性的命令成功发送到图表时，该函数才会返回true。否则返回false。要了解更多关于错误的信息，请调用GetLastError()。

注意

当此函数用于当前图表时，会直接访问该图表并立即返回结果。要在不同图表上设置对象属性，则使用异步调用。异步调用意味着该函数不会等待添加到另一个图表队列中的命令执行完毕，而是立即返回控制。

要检查其他图表上的命令执行结果，可以使用检查指定对象属性的函数。然而，需要注意的是，此类函数会被添加到该图表的队列末尾，并等待执行结果，因此可能会耗费时间。在处理图表上大量对象时，应考虑到这一特性。