ControlExtensions.AddTreeView Méthode

Définition

Surcharges

AddTreeView(ControlCollection, Range, String)

Ajoute un nouveau contrôle TreeView à la feuille de calcul à la plage spécifiée.

AddTreeView(ControlCollection, Double, Double, Double, Double, String)

Ajoute un nouveau contrôle TreeView à la feuille de calcul selon la taille et l'emplacement spécifiés.

AddTreeView(ControlCollection, Range, String)

Ajoute un nouveau contrôle TreeView à la feuille de calcul à la plage spécifiée.

public static Microsoft.Office.Tools.Excel.Controls.TreeView AddTreeView (this Microsoft.Office.Tools.Excel.ControlCollection controls, Microsoft.Office.Interop.Excel.Range range, string name);

Paramètres

controls
ControlCollection

Collection à laquelle le contrôle doit être ajouté. Ne spécifiez pas ce paramètre vous-même. Lorsque vous appelez cette méthode sur la collection retournée par la propriété Controls (dans un projet au niveau de l'application) ou la propriété Controls (dans un projet au niveau du document), ce paramètre est fourni automatiquement.

range
Range

Range qui fournit les limites du contrôle.

name
String

Nom du contrôle qui peut être utilisé pour indexer le contrôle dans l'instance ControlCollection.

Retours

TreeView

Contrôle TreeView qui a été ajouté à l'instance de ControlCollection.

Exceptions

L'argument de nom ou de plage a la valeur null ou l'argument de nom a une longueur nulle.

Un contrôle du même nom se trouve déjà dans l'instance de ControlCollection.

La plage spécifiée n'est pas valide. Les plages sur plusieurs zones ne peuvent pas être utilisées. La plage doit se trouver dans la même feuille de calcul que l'instance de ControlCollection.

Exemples

L’exemple de code suivant ajoute un TreeView contrôle aux cellules a1 à B6, puis ajoute un nœud parent et deux nœuds enfants au contrôle. Pour utiliser cet exemple, exécutez-le à partir de la Sheet1 classe dans un projet au niveau du document.

private void ExcelRangeAddTreeView()
{

    Microsoft.Office.Tools.Excel.Controls.TreeView
         treeView1 = this.Controls.AddTreeView(
         this.Range["A1", "B6"], "treeView1");

    treeView1.Nodes.Add("Customer Name");
    treeView1.Nodes[0].Nodes.Add("First Name");
    treeView1.Nodes[0].Nodes.Add("Last Name");
}
Private Sub ExcelRangeAddTreeView()

    Dim TreeView1 As Microsoft.Office.Tools.Excel. _
        Controls.TreeView = Me.Controls.AddTreeView( _
        Me.Range("A1", "B6"), "TreeView1")

    TreeView1.Nodes.Add("Customer Name")
    TreeView1.Nodes(0).Nodes.Add("First Name")
    TreeView1.Nodes(0).Nodes.Add("Last Name")

End Sub 

Remarques

La AddTreeView méthode vous permet d’ajouter TreeView des objets à la fin de ControlCollection . Pour supprimer un TreeView précédemment ajouté par programmation, utilisez la Remove méthode.

Le contrôle se redimensionne automatiquement lorsque la plage est redimensionnée.

S’applique à

AddTreeView(ControlCollection, Double, Double, Double, Double, String)

Ajoute un nouveau contrôle TreeView à la feuille de calcul selon la taille et l'emplacement spécifiés.

public static Microsoft.Office.Tools.Excel.Controls.TreeView AddTreeView (this Microsoft.Office.Tools.Excel.ControlCollection controls, double left, double top, double width, double height, string name);

Paramètres

controls
ControlCollection

Collection à laquelle le contrôle doit être ajouté. Ne spécifiez pas ce paramètre vous-même. Lorsque vous appelez cette méthode sur la collection retournée par la propriété Controls (dans un projet au niveau de l'application) ou la propriété Controls (dans un projet au niveau du document), ce paramètre est fourni automatiquement.

left
Double

Distance, en points, entre le bord gauche du contrôle et le bord gauche de la feuille de calcul.

top
Double

Distance, en points, entre le bord supérieur du contrôle et le bord supérieur de la feuille de calcul.

width
Double

Largeur du contrôle en points.

height
Double

Hauteur du contrôle en points.

name
String

Nom du contrôle.

Retours

TreeView

Contrôle TreeView qui a été ajouté à l'instance de ControlCollection.

Exceptions

L'argument de nom a la valeur null ou une longueur nulle.

Un contrôle du même nom se trouve déjà dans l'instance de ControlCollection.

Exemples

L’exemple de code suivant ajoute un TreeView contrôle en haut de la feuille de calcul, puis ajoute un nœud parent et deux nœuds enfants au contrôle. Pour utiliser cet exemple, exécutez-le à partir de la Sheet1 classe dans un projet au niveau du document.

private void ExcelAddTreeView()
{

    Microsoft.Office.Tools.Excel.Controls.TreeView
         treeView1 = this.Controls.AddTreeView(
         0, 0, 90.75, 72.75, "treeView1");

    treeView1.Nodes.Add("Customer Name");
    treeView1.Nodes[0].Nodes.Add("First Name");
    treeView1.Nodes[0].Nodes.Add("Last Name");
}
Private Sub ExcelAddTreeView()

    Dim TreeView1 As Microsoft.Office.Tools.Excel. _
        Controls.TreeView = Me.Controls.AddTreeView( _
        0, 0, 90.75, 72.75, "TreeView1")

    TreeView1.Nodes.Add("Customer Name")
    TreeView1.Nodes(0).Nodes.Add("First Name")
    TreeView1.Nodes(0).Nodes.Add("Last Name")

End Sub 'ExcelAddTreeView

Remarques

La AddTreeView méthode vous permet d’ajouter TreeView des objets à la fin de ControlCollection . Pour supprimer un TreeView contrôle qui a été précédemment ajouté par programme, utilisez la Remove méthode.

S’applique à