Worksheet.Controls 属性 (2007 system)

更新： 2008 年 7 月

获取工作表内包含的控件的集合。

命名空间：  Microsoft.Office.Tools.Excel
程序集：  Microsoft.Office.Tools.Excel.v9.0（在 Microsoft.Office.Tools.Excel.v9.0.dll 中）

语法

声明
<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; }

属性值

类型：Microsoft.Office.Tools.Excel.ControlCollection

一个 ControlCollection，其中包含工作表上的所有控件。

备注

工作表可用作控件集合的父级。向工作表添加多个控件时，每个控件都是该工作表的 ControlCollection 的一个成员。

可以使用在 ControlCollection 类中可用的方法向 ControlCollection 中添加控件或从中移除控件。

示例

下面的代码示例使用 Controls 属性向当前工作表添加一个 Button。

此版本针对的是文档级自定义项。

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");
}

此版本针对的是应用程序级外接程序。

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");
}

权限

• 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息，请参见通过部分受信任的代码使用库。

另请参见

参考

Worksheet 类

Worksheet 成员

Microsoft.Office.Tools.Excel 命名空间

修订记录

日期	修订记录	原因
2008 年 7 月	添加了一个针对应用程序级外接程序的代码示例版本。	SP1 功能更改。