Metoda ControlExtensions.AddTreeView — (ControlCollection, Single, Single, Single, Single, String)
Dodaje nowy TreeView formantu do dokumentu w określonym rozmiarze i lokalizacji.
Przestrzeń nazw: Microsoft.Office.Tools.Word
Zestaw: Microsoft.Office.Tools.Word.v4.0.Utilities (w Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Składnia
'Deklaracja
<ExtensionAttribute> _
Public Shared Function AddTreeView ( _
controls As ControlCollection, _
left As Single, _
top As Single, _
width As Single, _
height As Single, _
name As String _
) As TreeView
public static TreeView AddTreeView(
this ControlCollection controls,
float left,
float top,
float width,
float height,
string name
)
Parametry
- controls
Typ: Microsoft.Office.Tools.Word.ControlCollection
Aby dodać formant do kolekcji.Nie zostanie podany parametr ten sam.Jeśli wywołanie tej metody na kolekcja zwróconego przez Document.Controls właściwość (w projekcie poziomie aplikacji) lub DocumentBase.Controls właściwość (w projekcie poziomie dokumentu), parametr ten jest dostarczany automatycznie.
- left
Typ: System.Single
Odległość w punktach między lewą krawędzią formantu a lewą krawędzią dokumentu.
- top
Typ: System.Single
Odległość w punktach między górną krawędzią formantu a górną krawędzią dokumentu.
- width
Typ: System.Single
Szerokość formantu znajdującego się w punktach.
- height
Typ: System.Single
Wysokość formantu w punktach.
- name
Typ: System.String
Nazwy, które mogą być używane do indeksowania formantu znajdującego się w ControlCollection wystąpienie.
Wartość zwracana
Typ: Microsoft.Office.Tools.Word.Controls.TreeView
Formant, który został dodany do dokumentu.
Informacje dotyczące użycia
W językach Visual Basic i C# tę metodę można wywołać jako metodę wystąpienia dowolnego obiektu typu ControlCollection. Gdy w celu wywołania tej metody jest używana składnia metody wystąpienia, należy pominąć pierwszy parametr. Aby uzyskać więcej informacji, zobacz temat Metody rozszerzeń (Visual Basic) lub Metody rozszerzeń (Przewodnik programowania w języku C#).
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | name Argument jest nullodwołanie o wartości null (Nothing w języku Visual Basic) lub ma zerową długość. |
| ControlNameAlreadyExistsException | Formant o tej samej nazwie jest już w ControlCollection wystąpienie. |
Uwagi
Ta metoda umożliwia dodanie TreeView obiektów na koniec ControlCollection.
Aby usunąć TreeView kontroli, który został dodany programowo, użyj Remove metody.
Przykłady
Poniższy kod dodaje TreeView kontroli w dokumencie, a następnie dodaje węzeł nadrzędny i dwa węzły podrzędne do formantu.Aby wykorzystać ten przykład, należy uruchomić go z ThisDocument klasy w projekcie poziomie dokumentu.
Private Sub WordAddTreeView()
Me.Paragraphs(1).Range.InsertParagraphBefore()
Dim TreeView1 As Microsoft.Office.Tools.Word.Controls. _
TreeView = Me.Controls.AddTreeView(0, 0, 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 WordAddTreeView()
{
this.Paragraphs[1].Range.InsertParagraphBefore();
Microsoft.Office.Tools.Word.Controls.TreeView
treeView1 = this.Controls.AddTreeView(
0, 0, 90.75F, 72.75F, "treeView1");
treeView1.Nodes.Add("Customer Name");
treeView1.Nodes[0].Nodes.Add("First Name");
treeView1.Nodes[0].Nodes.Add("Last Name");
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.