Ets_Obj_Attr_Set_From_String()
摘要
使用字符串设置指定对象的指定属性的值。
语法
Ets_Obj_Attr_Set_From_String (obj_hndl, attr_name, value_str)
| 参数 | 类型 | 说明 |
|---|---|---|
obj_hndl |
EtsT_Obj_Handle |
被修改对象的句柄。 |
attr_name |
const char * |
被修改属性的名称。 |
value_str |
const char * |
用于指定新值的字符串。 |
返回类型
EtsT_Compcode
若属性存在且已被设置则返回 EtsC_Compcode_Success,否则返回 EtsC_Compcode_Failure。
头文件
ets_api_obj.h
详情
指定对象必须已经具有该名称的属性,该属性必须可修改,且值字符串必须位于该属性的符号映射(symbol map)中,或者与该属性的类型相匹配。
复合对象属性只能用属性符号映射中的符号来设置。对于整型和浮点型属性,如果字符串不是符号,则应是有效的、字符串化的数值。对于布尔属性,字符串“1”、“enabled”、“true”和“TRUE”表示真值,其他字符串表示假值。对于颜色属性,字符串应采用“#xxxxxx”(其中“x”为 hexidecimal 十六进制数字)或“RGBnnn”(其中“n”为 0–3 范围内的数字)形式。