函數(shù)設(shè)置相應(yīng)對象屬性的值得滤。對象屬性必須是字符串類型俊抵。這個函數(shù)有兩個變體。
設(shè)置屬性值诅妹,不修改:
bool ObjectSetString(
long chart_id, //圖表標(biāo)識符
string object_name, //對象名稱
int prop_id, //屬性
string prop_value //值
設(shè)置一個屬性值芜抒,指示修改器:
bool ObjectSetString(
long chart_id, //圖表標(biāo)識符 chart identifier
string object_name, //對象名稱 object name
int prop_id, //屬性 property
int prop_modifier, //修飾符 modifier
string prop_value //值 value
);
參數(shù)
chart_id
[in]表標(biāo)識符扭倾。0表示當(dāng)前圖表。
object_name
以物體的名義挽绩。
prop_id
對象屬性的ID膛壹。該值可以是ENUM_OBJECT_PROPERTY_STRING枚舉的值之一。
prop_modifier
[in]指定屬性的修飾符。它表示斐波那契工具和圖形對象Andrew的干草叉中級別的數(shù)量模聋。能級的計(jì)算從0開始肩民。
prop_value
財(cái)產(chǎn)的價值。
返回值
只有當(dāng)更改圖形對象屬性的命令成功發(fā)送到圖表時链方,函數(shù)才返回true持痰。否則返回false。要了解有關(guān)錯誤調(diào)用GetLastError()的更多信息祟蚀,請參閱工窍。
請注意
當(dāng)在當(dāng)前圖表上使用此函數(shù)時,將直接訪問此圖表前酿,并立即返回結(jié)果患雏。為了在不同的圖表上設(shè)置對象屬性,使用異步調(diào)用罢维。異步調(diào)用意味著函數(shù)不等待已添加到另一個圖表隊(duì)列的命令的執(zhí)行淹仑。相反,它立即返回控制權(quán)肺孵。
要檢查當(dāng)前圖表之外的命令執(zhí)行結(jié)果匀借,可以使用檢查指定對象屬性的函數(shù)。但是平窘,您應(yīng)該記住吓肋,這些函數(shù)被添加到圖表隊(duì)列的末尾,并等待執(zhí)行結(jié)果瑰艘,因此會很耗時是鬼。在處理圖表上的大量對象時,應(yīng)該考慮到這個特性磅叛。