Freigeben über


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

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.