树状图控件

描述

树状图控件是使用可折叠的节点将信息显示为层级结构的控件。可用于Standard版和Premium版。

使用

使用树状图控件,将信息显示为层级结构。

设计时:

  1. 点击TreeNodeEditor属性按钮,打开[TreeNodeEditor]对话框。

  2. 在[TreeNodeEditor]对话框中进行节点的添加、删除或排序。

  3. 设置各节点的名称和文本之后,关闭[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的应用示例(多类别设置画面):

通过与其他控件组合使用,可以应用于设置分为多个类别的项目的画面。

  1. 按如下设置控件的布局。
    • 左侧:树状图控件
    • 中央:向导控件
    • 右侧:按钮控件

  1. 使用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 变更节点选择时执行。