樹狀檢視控制項

描述

樹狀檢視控制項是使用可折疊節點,在階層結構中顯示資訊的控制項。可於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 重新選擇節點時執行。