ControlExtensions 类

项目
05/20/2013

提供一些扩展方法，可以使用这些方法向已使用 Visual Studio 中的 Office 开发工具自定义的 Excel 工作表中添加 Windows 窗体控件。

继承层次结构

System.Object
Microsoft.Office.Tools.Excel.ControlExtensions

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

语法

声明
<ExtensionAttribute> _
Public NotInheritable Class ControlExtensions

public static class ControlExtensions

方法

	名称	说明
	AddButton(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 Button 控件。
	AddButton(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 Button 控件。
	AddCheckBox(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 CheckBox 控件。
	AddCheckBox(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 CheckBox 控件。
	AddCheckedListBox(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 CheckedListBox 控件。
	AddCheckedListBox(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 CheckedListBox 控件。
	AddComboBox(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 ComboBox 控件。
	AddComboBox(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 ComboBox 控件。
	AddDataGridView(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 DataGridView 控件。
	AddDataGridView(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 DataGridView 控件。
	AddDateTimePicker(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 DateTimePicker 控件。
	AddDateTimePicker(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 DateTimePicker 控件。
	AddDomainUpDown(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 DomainUpDown 控件。
	AddDomainUpDown(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 DomainUpDown 控件。
	AddHScrollBar(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 HScrollBar 控件。
	AddHScrollBar(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 HScrollBar 控件。
	AddLabel(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 Label 控件。
	AddLabel(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 Label 控件。
	AddLinkLabel(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 LinkLabel 控件。
	AddLinkLabel(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 LinkLabel 控件。
	AddListBox(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 ListBox 控件。
	AddListBox(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 ListBox 控件。
	AddListView(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 ListView 控件。
	AddListView(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 ListView 控件。
	AddMaskedTextBox(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 MaskedTextBox 控件。
	AddMaskedTextBox(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向文档中添加一个新的 MaskedTextBox 控件。
	AddMonthCalendar(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 MonthCalendar 控件。
	AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 MonthCalendar 控件。
	AddNumericUpDown(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 NumericUpDown 控件。
	AddNumericUpDown(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 NumericUpDown 控件。
	AddPictureBox(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 PictureBox 控件。
	AddPictureBox(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 PictureBox 控件。
	AddProgressBar(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 ProgressBar 控件。
	AddProgressBar(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 ProgressBar 控件。
	AddPropertyGrid(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 PropertyGrid 控件。
	AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 PropertyGrid 控件。
	AddRadioButton(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 RadioButton 控件。
	AddRadioButton(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 RadioButton 控件。
	AddRichTextBox(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 RichTextBox 控件。
	AddRichTextBox(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 RichTextBox 控件。
	AddTextBox(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 TextBox 控件。
	AddTextBox(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 TextBox 控件。
	AddTrackBar(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 TrackBar 控件。
	AddTrackBar(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 TrackBar 控件。
	AddTreeView(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 TreeView 控件。
	AddTreeView(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 TreeView 控件。
	AddVScrollBar(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 VScrollBar 控件。
	AddVScrollBar(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 VScrollBar 控件。
	AddWebBrowser(ControlCollection, Range, String)	在工作表中的指定范围添加一个新的 WebBrowser 控件。
	AddWebBrowser(ControlCollection, Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 WebBrowser 控件。

页首

备注

ControlExtensions 方法是扩展方法，运行时在由 Worksheet.Controls 属性（在应用程序级项目中）或 WorksheetBase.Controls 属性（在文档级项目中）返回的 ControlCollection 对象上可用。若要向文档中添加特定的控件，请使用方法名称中包含了该控件名称的方法。例如，要想添加 Button，就需要使用 AddButton 方法。

有关文档控件的更多信息，请参见在运行时向 Office 文档添加控件。有关扩展方法的更多信息，请参见扩展方法（C# 编程指南）和扩展方法 (Visual Basic)。

备注

在面向 .NET Framework 4 的 Excel 外接程序项目中，必须先添加对 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 程序集的引用，然后才能访问 ControlExtensions 方法。

示例

下面的代码示例使用 AddButton 方法向单元格 A1 中添加 Button 控件，然后向按钮中添加文本。若要使用此示例，请从文档级项目内的 Sheet1 类中运行此示例。

    Private Sub ExcelRangeAddButton()

        Dim Button1 As Microsoft.Office.Tools.Excel. _
          Controls.Button = Me.Controls.AddButton( _
          Me.Range("A1"), "Button1")
        Button1.Text = "OK"

    End Sub

private void ExcelRangeAddButton()
{

    Microsoft.Office.Tools.Excel.Controls.Button button1 =
        this.Controls.AddButton(this.Range["A1"], "button1");
    button1.Text = "OK";
}

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared）成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

Microsoft.Office.Tools.Excel 命名空间

通过

ControlExtensions 类

继承层次结构

语法

方法

备注

示例

线程安全

请参见

参考

其他资源