ControlExtensions.AddTreeView 方法 (ControlCollection, Range, Single, Single, String)
將新的 TreeView 控制項加入至指定之大小和位置的文件中。
命名空間: Microsoft.Office.Tools.Word
組件: Microsoft.Office.Tools.Word.v4.0.Utilities (在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中)
語法
'宣告
<ExtensionAttribute> _
Public Shared Function AddTreeView ( _
controls As ControlCollection, _
range As Range, _
width As Single, _
height As Single, _
name As String _
) As TreeView
public static TreeView AddTreeView(
this ControlCollection controls,
Range range,
float width,
float height,
string name
)
參數
- controls
型別:Microsoft.Office.Tools.Word.ControlCollection
要加入控制項的集合。請勿自行提供此參數。當您在 Document.Controls 屬性 (在應用程式層級的專案中) 或 DocumentBase.Controls 屬性 (在文件層級的專案中) 所傳回的集合上呼叫這個方法時,會自動提供這個參數。
- range
型別:Microsoft.Office.Interop.Word.Range
控制項的位置。
- width
型別:System.Single
控制項的寬度 (以點為單位)。
- height
型別:System.Single
控制項的高度 (以點為單位)。
- name
型別:System.String
可用於索引 ControlCollection 執行個體中的控制項之名稱。
傳回值
型別:Microsoft.Office.Tools.Word.Controls.TreeView
已加入至文件的控制項。
使用注意事項
在 Visual Basic 和 C# 中,您可以在任何 ControlCollection 型別物件中呼叫這個方法以做為執行個體。使用執行個體方法語法呼叫這個方法時,請省略第一個參數。如需詳細資訊,請參閱擴充方法 (Visual Basic)或擴充方法 (C# 程式設計手冊)。
例外狀況
例外狀況 | 條件 |
---|---|
ArgumentNullException | name 或 range 引數是 nullnull 參考 (即 Visual Basic 中的 Nothing),或者,name 引數的長度為 0。 |
ControlNameAlreadyExistsException | 具有相同名稱的控制項已經存在於 ControlCollection 執行個體中。 |
InvalidRangeException | 指定的範圍無效。 |
備註
這個方法可以讓您將 TreeView 物件加入至 ControlCollection 的尾端。
若要移除以程式設計方式加入的 TreeView 控制項,請使用 Remove 方法。
範例
下列程式碼範例加入 TreeView 控制項至文件的第一個段落,然後加入一個父節點和兩個子節點至控制項。 若要使用這個範例,請在文件層級專案中的 ThisDocument 類別執行。
Private Sub WordRangeAddTreeView()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim TreeView1 As Microsoft.Office.Tools.Word.Controls. _
TreeView = Me.Controls.AddTreeView(Me.Paragraphs(1). _
Range, 90.75F, 72.75F, "TreeView1")
TreeView1.Nodes.Add("Customer Name")
TreeView1.Nodes(0).Nodes.Add("First Name")
TreeView1.Nodes(0).Nodes.Add("Last Name")
End Sub
private void WordRangeAddTreeView()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Controls.TreeView
treeView1 = this.Controls.AddTreeView(
this.Paragraphs[1].Range, 90.75F, 72.75F, "treeView1");
treeView1.Nodes.Add("Customer Name");
treeView1.Nodes[0].Nodes.Add("First Name");
treeView1.Nodes[0].Nodes.Add("Last Name");
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。