力控组态软件ForceControl 的Windows 控件 树形菜单 的控件方法
GetSelItemData
语法： #TreeMenu.GetSelItemData()
功能： 获得树形菜单中被选中项中附带的数值
返回值： int
参数： 无
说明： 获得树形菜单中被选中项中附带的数值
示例： abc = #TreeMenu.GetSelItemName() // 获得树形菜单中被选中项中附带的数值，并赋值给变量 abc。
GetSelItemName
语法： #TreeMenu.GetSelItemName()
功能： 获得树形菜单中被选中项的名称
返回值： string
参数： 无
说明： 获得树形菜单中被选中项的名称 , 该名称实际上是菜单项显示的文本
示例： abc = #TreeMenu.GetSelItemName() // 获得树形菜单中被选中项的名称，并赋值给变量 abc。
GetItemData
语法： GetItemData(cString csKeyword)
功能： 获取指定菜单项的数值
返回值： 整型
参数： csKeyword – 字符型 , 菜单项的路径
说明： 获取指定菜单项的数值
示例： #TreeMenu1Name.GetItemData(“root2.NewSubItem #1”) // 获取TreeMenu1Name 型控件的 root2.NewSubItem #1 项的数值 , 返回值赋给 nData。
SetItemData
语法： SetItemData(cString csKeyword， int nData)
功能： 设置指定菜单项的数值
返回值： 整型
参数： csKeyword – 字符型，需要设置数值的菜单项；nData- 整型 , 允许用户给菜单项设定
的一个值。
说明： 菜单项设定值是留给用户存放一个整型数的空间，可以设定也可以不设，不设定值则系
统默认为 -1。本函数是在运行状态下动态设定菜单项的值 ，不会改变组态情况下的设定。
示例： #TreeMenu1Name.SetItemData(“root2.NewSubItem #1”,8)
// 将 #TreeMenu1Name 树型控件的 root2.NewSubItem #1 项的数值设定为 8，
// 成功返回 1 失败返回 0
DeletItem
语法： DeletItem(cString csKeyword)
功能： 删除指定菜单项
返回值： 整型
参数： csKeyword – 字符型 , 需要删除的菜单项
说明： 本函数是在运行状态下动态删除菜单项，不会改变组态情况下的设定。
示例： #TreeMenu1Name.DeletItem(“root2.NewSubItem #1”) // 将 #TreeMenu1Name 树
型控件的 root2.NewSubItem #1 项删除， // 成功返回 1 失败返回 0
ModifyItem
语法： ModifyItem(cString csKeyword, cString text)
功能： 编辑指定菜单项的名称
返回值： 整型
参数： csKeyword – 字符型，需要编辑的菜单项；text- 字符型 , 变更名称。
说明： 更改菜单项的名称会改变本分支的索引目录，因为在本控件中菜单项的数值也是根据这个目录来赋值的，所以改变菜单项名称后本项目录以下的项的值和脚本都将发生变化，所以要在设定值和编写脚本前改名字。如果已经做了以上工作，那么必须重写。
示例： #TreeMenu1Name.ModifyItem(“root2.NewSubItem #1″,”NewName”)
// 将 #TreeMenu1Name 树型控件的 root2.NewSubItem #1 项的名字变更为 NewName。
AddnewChildItem
语法： AddnewChildItem(cString csKeyword, cString text)
功能： 在指定目录添加子菜单项
返回值： 整型
参数： csKeyword- 字符型， 需要添加子菜单的目录；
Text- 字符型 , 添加子菜单的名称。
说明： 在指定目录添加子菜单项，本操作是在运行状态下动态的添加项，不改变组态结果
示例： #TreeMenuName.AddNewSubItem(“NewItem #2.NewSubItem #1″,”ChildItemName”)
// 在 #TreeMenuName 树型菜单中的 NewItem #2.NewSubItem #1 目录下添加菜单项
AddnewItem
语法： AddnewItem(cString csKeyword, cString text)
功能： 在指定目录添加菜单项
返回值： 整型
参数： csKeyword – 字符型 , 需要添加菜单的目录 ; text – 字符型 , 添加菜单的名称；
说明： 在指定目录添加菜单项，目录指定到添加项的上面一个节点，如果不指定则不添加。本
操作是在运行状态下动态的添加项，不改变组态结果
示例： #TreeMenu1Name.AddnewItem(“NewItem #2.NewSubItem #1″,”NewItem”)
// 在 #TreeMenu1Name 树型菜单中的 NewItem #2.NewSubItem #1 目录下添加菜单项