树状图控件
描述
树状图控件是使用可折叠的节点将信息显示为层级结构的控件。可用于Standard版和Premium版。
使用
使用树状图控件,将信息显示为层级结构。
设计时:
点击TreeNodeEditor属性按钮,打开[TreeNodeEditor]对话框。
在[TreeNodeEditor]对话框中进行节点的添加、删除或排序。
设置各节点的名称和文本之后,关闭[TreeNodeEditor]对话框。
有关[TreeNodeEditor]对话框的详细信息,请参阅以下章节。
TreeNodeEditor属性
执行:
可以使用以下属性对节点进行添加、删除、排序及文本更改。
- AddNode属性
- RemoveNode属性
- Parent属性
- Text属性
Function AddNode
String parentNodeName$, childNodeName$
parentNodeName$ = "Node1"
childNodeName$ = "Node2"
'添加节点。
GSet frmMain.TreeView1.AddNode, parentNodeName$
GSet frmMain.TreeView1.AddNode, childNodeName$
'设置显示在节点的字符串。
GSet frmMain.TreeView1.Text(parentNodeName$), "Node-1"
GSet frmMain.TreeView1.Text(childNodeName$), "Node-2"
'设置节点的父子关系。(将childNodeName$的父节点设置到parentNodeName$。)
GSet frmMain.TreeView1.Parent(childNodeName$), parentNodeName$
Fend
Function RemoveNode(nodeName$ As String)
'删除节点。(删除父节点时,子节点也将被删除。)
GSet frmMain.TreeView1.RemoveNode, nodeName$
Fend
执行AddNode函数后,将显示以下画面。
TreeView的应用示例(多类别设置画面):
通过与其他控件组合使用,可以应用于设置分为多个类别的项目的画面。
- 按如下设置控件的布局。
- 左侧:树状图控件
- 中央:向导控件
- 右侧:按钮控件
- 使用SelectedNodeChanged事件,当树状图控件中选中的节点变更时,将切换向导控件的页面。
Function frmMain_TreeView1_SelectedNodeChanged(Sender$ As String, NodeName$ As String)
Integer wizardIndex
' 根据所选节点切换向导控件的显示页面
Select NodeName$
Case "TreeNode1"; wizardIndex = 0
Case "TreeNode2"; wizardIndex = 1
Case "TreeNode3"; wizardIndex = 2
Case "TreeNode4"; wizardIndex = 3
Case "TreeNode5"; wizardIndex = 4
Case "TreeNode6"; wizardIndex = 5
Send
GSet frmMain.Wizard1.SelectedIndex, wizardIndex
Fend
树状图的属性
| 属性 | 描述 |
|---|---|
| AddNode | 添加指定的节点。(仅从SPEL程序更改时有效) |
| BackColor | 设置控件的背景颜色。 默认:Window |
| BorderStyle | 设置控件的边框样式。 默认:Fixed3D |
| Enabled | 设置是否启用控件。 默认:True |
| EventTaskType | 设置用于事件的任务类型。 默认:Normal |
| Font | 设置控件文本的字体。 默认:Microsoft Sans Serif 8.25 pt |
| FontBold | 将当前字体设为粗体。 默认:False |
| FontItalic | 将当前字体设为斜体。 默认:False |
| FontName | 设置当前字体的名称。 默认:Microsoft Sans Serif |
| FontSize | 以点设置当前字体的大小。 默认:8.25 |
| ForeColor | 设置控件的文本颜色。 默认:WindowText |
| Height | 设置控件的高度,以像素为单位。 |
| Left | 设置控件显示位置的左坐标,以像素为单位。 |
| Name | 设置控件的名称。 默认:TreeViewXX |
| Parent | 获取或设置指定节点的父节点。(仅从SPEL程序更改时有效) |
| RemoveNode | 删除指定的节点。(仅从SPEL程序更改时有效) |
| TabIndex | 设置控件的选项卡索引。 |
| Text | 设置控件的显示文本。默认:空白 |
| ToolTipText | 设置控件的工具提示中显示的文本。 默认:空 |
| Top | 设置控件显示位置的上坐标,以像素为单位。删除指定的节点。(仅从SPEL程序更改时有效) |
| TreeNodeEditor | 显示用于进行节点的添加、删除及排序所需的树状图节点编辑器画面。 |
| Visible | 设置显示或隐藏控件。 默认:True |
| Width | 设置控件的宽度,以像素为单位。 |
树状图事件
| 事件 | 描述 |
|---|---|
| Click | 当控件被点击时执行。 |
| SelectedNodeChanged | 变更节点选择时执行。 |