ControlCollection 介面

發行項
05/07/2013

代表 Office 方案中 Excel 工作表上的 Managed 控制項集合。

命名空間： 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<control> 方法。比方說，要加入 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 介面

語法

屬性

方法

擴充方法

備註

使用方式

請參閱

參考

其他資源