setpointattrib

如果事先不知道属性类别，请使用setattrib。

int  setpointattrib(int geohandle, string name, int point_num, <type>value, string mode="set")

int  setpointattrib(int geohandle, string name, int point_num, <type>value[], string mode="set")

成功时返回geohandle的值，失败时返回-1。

注意 如果属性不存在，此函数会创建该属性，默认值为零、空字符串或空数组。 如果要控制数值属性的默认值，请在设置属性前使用addattrib。

如果属性尚不存在，对于具有标准名称（如Cd和orient）的属性，其类型信息会自动设置。 如果要控制数值属性的类型信息，请在设置属性前使用setattribtypeinfo。

geohandle

要写入的几何体句柄。目前唯一有效的值是0或geoself，表示节点中的当前几何体。（此参数未来可能用于支持写入其他几何体。）

name

要在给定点上设置的属性名称。

point_num

要设置属性的点编号。

value

要设置的属性值。

注意在VEX程序中，单个属性只能写入一种类型。例如，不能混合写入浮点和整数值。这可能会令人意外，因为像1这样的字面量会被视为整数写入，如果之前写入的是浮点数，则会被忽略。

mode

（可选）如果提供，此参数控制函数如何修改属性中的现有值。

"set"	用给定值覆盖属性。
"add"	将值添加到属性中。
"min", "minimum"	将属性设置为其本身与给定值中的较小者。
"max", "maximum"	将属性设置为其本身与给定值中的较大者。
"mult", "multiply"	将属性乘以给定值。对于矩阵，这将执行矩阵乘法；对于向量，则是分量相乘。
"toggle"	切换属性，与源值无关。适用于切换组成员资格。
"append"	适用于字符串、字典和数组属性。对于字符串和数组，将源值追加到原始值的末尾。对于字典，用源字典更新原始字典，替换任何匹配的键。