ControlExtensions.AddTreeView Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
- name
- String
Nom du contrôle qui peut être utilisé pour indexer le contrôle dans l'instance ControlCollection.
Retours
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
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.