Worksheet.Controls-Eigenschaft (2007 System)

Aktualisiert: Juli 2008

Ruft die Auflistung der Steuerelemente im Arbeitsblatt ab.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v9.0 (in Microsoft.Office.Tools.Excel.v9.0.dll)

Syntax

<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property Controls As ControlCollection

Dim instance As Worksheet
Dim value As ControlCollection

value = instance.Controls

[BrowsableAttribute(false)]
public virtual ControlCollection Controls { get; }

Eigenschaftenwert

Typ: Microsoft.Office.Tools.Excel.ControlCollection

Eine ControlCollection, die alle Steuerelemente im Arbeitsblatt enthält.

Hinweise

Ein Arbeitsblatt kann gegenüber einer Auflistung von Steuerelementen als übergeordnetes Element fungieren. Wenn einem Arbeitsblatt mehrere Steuerelemente hinzugefügt werden, ist jedes der Steuerelemente ein Member der ControlCollection des Arbeitsblatts.

Sie können der ControlCollection Steuerelemente hinzufügen oder diese mithilfe der in der ControlCollection-Klasse verfügbaren Methoden entfernen.

Beispiele

Im folgenden Codebeispiel wird die Controls-Eigenschaft verwendet, um dem aktuellen Arbeitsblatt eine Button hinzuzufügen.

Diese Version bezieht sich auf eine Anpassung auf Dokumentebene.

Private Sub AddButton()
    Dim button1 As Button = _
        Me.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton

private void AddButton()
{
    Button button1 = this.Controls.AddButton(50, 50, 150, 50, "button1");
}

Diese Version bezieht sich auf ein Add-In auf Anwendungsebene.

Private Sub AddButton()
    Dim vstoWorksheet As Worksheet = _
        CType(Me.Application.ActiveWorkbook.Worksheets(1), Excel.Worksheet) _
        .GetVstoObject()
    Dim button1 As System.Windows.Forms.Button = _
        vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1")
End Sub 'AddButton

private void AddButton()
{
    Worksheet vstoWorksheet = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    System.Windows.Forms.Button button1 = 
        vstoWorksheet.Controls.AddButton(50, 50, 150, 50, "button1");
}

Berechtigungen

• 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.

Siehe auch

Referenz

Worksheet-Klasse

Worksheet-Member

Microsoft.Office.Tools.Excel-Namespace

Änderungsprotokoll

Date	Versionsgeschichte	Grund
Juli 2008	Version des Codebeispiels für ein Add-In auf Anwendungsebene hinzugefügt.	SP1-Featureänderung.