Worksheet.Controls-Eigenschaft
Ruft die Auflistung von verwalteten Steuerelementen ab, die auf dem Arbeitsblatt enthalten sind.
Namespace: Microsoft.Office.Tools.Excel
Assemblys: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)
Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)
Syntax
'Declaration
ReadOnly Property Controls As ControlCollection
ControlCollection Controls { get; }
Eigenschaftswert
Typ: Microsoft.Office.Tools.Excel.ControlCollection
Eine ControlCollection, die alle verwalteten Steuerelemente im Arbeitsblatt enthält.
Hinweise
Ein Arbeitsblatt in einer Office-Projektmappe kann Windows Forms-Steuerelemente und Hoststeuerelemente enthalten.Weitere Informationen finden Sie unter Steuerelemente für Office-Dokumente.
Um die Steuerelemente in einem Arbeitsblatt zur Laufzeit zu verwalten, verwenden Sie die Methoden und Eigenschaften des ControlCollection-Objekts, das von der Controls-Eigenschaft zurückgegeben wird.Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit
Beispiele
Im folgenden Codebeispiel wird die Controls-Eigenschaft verwendet, um dem aktuellen Arbeitsblatt eine Button hinzuzufügen.
Dieses Beispiel bezieht sich auf ein Add-In auf Anwendungsebene.
Private Sub AddButton()
Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveWorksheet("Sheet1")
Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
Globals.Factory.GetVstoObject(NativeWorksheet)
Dim button1 As System.Windows.Forms.Button = _
vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton
private void AddButton()
{
Worksheet vstoWorksheet = Globals.Factory.GetVstoObject(
this.Application.ActiveWorkbook.Worksheets[1]);
System.Windows.Forms.Button button1 =
vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1");
}
.NET Framework-Sicherheit
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.