ControlCollection 接口

项目
05/20/2013

表示 Office 解决方案中 Excel 工作表中的托管控件的集合。

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

语法

声明
<GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")> _
Public Interface ControlCollection _
    Inherits IEnumerable

[GuidAttribute("0B027FC3-018C-4917-AE33-A09E0A30A661")]
public interface ControlCollection : IEnumerable

ControlCollection 类型公开以下成员。

属性

	名称	说明
	Count	获取 ControlCollection 中控件的数目。
	Item[Int32]	获取指定索引处的控件。
	Item[String]	获取具有指定名称的控件。

页首

方法

	名称	说明
	_VtblGap1_5
	AddChart(Range, String)	在工作表中的指定范围添加一个新的 Chart 控件。
	AddChart(Double, Double, Double, Double, String)	按照指定的大小和位置向工作表添加一个新的 Chart 控件。
	AddControl(Control, Range, String)	将指定的 Control 添加到 ControlCollection 中的指定范围。
	AddControl(Control, Double, Double, Double, Double, String)	按照指定的位置和大小将指定的 Control 添加到 ControlCollection。
	AddListObject(ListObject)	将一个 Visual Studio Microsoft.Office.Tools.Excel.ListObject 添加到基于指定的本机 Microsoft.Office.Interop.Excel.ListObject 的控件集合。
	AddListObject(Range, String)	在工作表中的指定范围添加一个新的 ListObject 控件。
	AddNamedRange	在工作表中的指定范围添加一个新的 NamedRange 控件。
	Contains(Object)	确定指定的控件是否为 ControlCollection 实例的成员。
	Contains(String)	确定具有指定名称的控件是否为 ControlCollection 实例的成员。
	GetEnumerator	返回一个循环访问集合的枚举数。（继承自 IEnumerable。）
	IndexOf(Object)	搜索指定控件，并返回该控件在 ControlCollection 实例中的第一个匹配项的从零开始的索引。
	IndexOf(String)	搜索具有指定名称的控件在 ControlCollection 实例中的第一个匹配项。
	Remove(Object)	从 ControlCollection 实例中移除指定的控件。
	Remove(String)	从 ControlCollection 实例中移除具有指定名称的控件。
	RemoveAt	移除 ControlCollection 实例中指定索引处的控件。

页首

扩展方法

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

页首

备注

使用 ControlCollection 接口的方法和属性来管理 Excel 工作表上的控件。有关更多信息，请参见在运行时向 Office 文档添加控件。

您不能在代码中创建此接口的实例，因为它没有任何公共构造函数。若要获取文档级项目中此接口的实例，请使用您项目中的 Sheetn 类之一的 Controls 属性。若要获取文档级项目中此接口的实例，请使用在运行时以编程方式创建的 Worksheet 宿主项的 Controls 属性。有关更多信息，请参见在运行时在应用程序级外接程序中扩展 Word 文档和 Excel 工作簿。

下表演示如何使用 ControlCollection 成员来执行与文档中的控件相关的某些常规任务。

任务	操作
将控件添加到工作表。	使用 Add<控件> 方法之一。例如，要想添加 Microsoft.Office.Tools.Excel.ListObject，就需要使用 AddListObject 方法。
从工作表中移除控件。	请使用 Remove 方法。
确定控件是否在集合中。	将控件及其名称传给 Contains 方法。
获取集合中控件的索引。	将控件及其名称传给 IndexOf 方法。
从集合获取控件。	将该控件的索引或名称传递给 Item 属性。

说明
此接口由 Visual Studio Tools for Office Runtime 实现。不应在代码中实现此接口。有关更多信息，请参见 Visual Studio Tools for Office Runtime 概述。

用法

本文档介绍面向 .NET Framework 4 和 .NET Framework 4.5 的 Office 项目中所用此类型的版本。在面向 .NET Framework 3.5 的项目中，此类型可能具有不同的成员，因此本文档为此类型提供的代码示例可能并不适用。有关面向 .NET Framework 3.5 的项目中的此类型的文档，请参见 Visual Studio 2008 文档中的以下参考部分：https://go.microsoft.com/fwlink/?LinkId=160658。

请参见

参考

Microsoft.Office.Tools.Excel 命名空间

通过

ControlCollection 接口

语法

属性

方法

扩展方法

备注

用法

请参见

参考

其他资源