Windows Form 控制項的 Helper 方法

您可以透過程式設計的方式，使用專案中提供的 Helper 方法在執行階段將 Windows Form 控制項加入至 Microsoft Office Word 文件和 Microsoft Office Excel 活頁簿。 如需詳細資訊，請參閱在執行階段將控制項加入至 Office 文件。

**適用於：**本主題中的資訊適用於下列應用程式的文件層級專案和應用程式層級專案：Excel 2007 和 Excel 2010、Word 2007 和 Word 2010。如需詳細資訊，請參閱依 Office 應用程式和專案類型提供的功能。

Excel 的 Helper 方法

若要在執行階段將 Windows Form 控制項加入至工作表，請使用 Worksheet.Controls 屬性 (於應用程式層級專案中) 或 WorksheetBase.Controls 屬性 (於文件層級專案中) 傳回的 ControlCollection 物件上提供的 Helper 方法。 每一個 Helper 方法都是多載，所以您可以傳入 Range 或特定位置座標。 當藉由傳遞 Range 以建立控制項時，如果範圍內的儲存格重新調整大小，控制項也會自動重新調整大小。

注意事項
在目標為 .NET Framework 4 的 Excel 增益集專案中，您必須先加入 Microsoft.Office.Tools.Excel.v4.0.Utilities.dll 組件的參考，才能存取 Helper 方法。

下表列出 Helper 方法，您可以使用這些方法，以程式設計方式將 Windows Form 控制項加入至 Excel 活頁簿。

Helper 方法	說明
AddButton(ControlCollection, Range, String)	將 Button 控制項加入至指定的範圍。
AddButton(ControlCollection, Double, Double, Double, Double, String)	將 Button 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
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 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddTextBox(ControlCollection, Range, String)	將 TextBox 控制項加入至指定的範圍。
AddTextBox(ControlCollection, Double, Double, Double, Double, String)	將 TextBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddCheckBox(ControlCollection, Range, String)	將 CheckBox 控制項加入至指定的範圍。
AddCheckBox(ControlCollection, Double, Double, Double, Double, String)	將 CheckBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddRadioButton(ControlCollection, Range, String)	將 RadioButton 控制項加入至指定的範圍。
AddRadioButton(ControlCollection, Double, Double, Double, Double, String)	將 RadioButton 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddPictureBox(ControlCollection, Range, String)	將 PictureBox 控制項加入至指定的範圍。
AddPictureBox(ControlCollection, Double, Double, Double, Double, String)	將 PictureBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
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 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddListView(ControlCollection, Range, String)	將 ListView 控制項加入到指定的範圍，設定控制項的位置和大小。
AddListView(ControlCollection, Double, Double, Double, Double, String)	將 ListView 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddTreeView(ControlCollection, Range, String)	將 TreeView 控制項加入至指定的範圍。
AddTreeView(ControlCollection, Double, Double, Double, Double, String)	將 TreeView 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddDateTimePicker(ControlCollection, Range, String)	將 DateTimePicker 控制項加入至指定的範圍。
AddDateTimePicker(ControlCollection, Double, Double, Double, Double, String)	將 DateTimePicker 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddMonthCalendar(ControlCollection, Range, String)	將 MonthCalendar 控制項加入至指定的範圍。
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)	將 MonthCalendar 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddDomainUpDown(ControlCollection, Range, String)	將 DomainUpDown 控制項加入至指定的範圍。
AddDomainUpDown(ControlCollection, Double, Double, Double, Double, String)	將 DomainUpDown 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddNumericUpDown(ControlCollection, Range, String)	將 NumericUpDown 控制項加入至指定的範圍。
AddNumericUpDown(ControlCollection, Double, Double, Double, Double, String)	將 NumericUpDown 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddTrackBar(ControlCollection, Range, String)	將 TrackBar 控制項加入至指定的範圍。
AddTrackBar(ControlCollection, Double, Double, Double, Double, String)	將 TrackBar 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddRichTextBox(ControlCollection, Range, String)	將 RichTextBox 控制項加入至指定的範圍。
AddRichTextBox(ControlCollection, Double, Double, Double, Double, String)	將 RichTextBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddDataGridView(ControlCollection, Range, String)	將 DataGridView 控制項加入至指定的範圍。
AddDataGridView(ControlCollection, Double, Double, Double, Double, String)	將 DataGridView 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddHScrollBar(ControlCollection, Range, String)	將 HScrollBar 控制項加入至指定的範圍。
AddHScrollBar(ControlCollection, Double, Double, Double, Double, String)	將 HScrollBar 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddVScrollBar(ControlCollection, Range, String)	將 VScrollBar 控制項加入至指定的範圍。
AddVScrollBar(ControlCollection, Double, Double, Double, Double, String)	將 VScrollBar 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddPropertyGrid(ControlCollection, Range, String)	將 PropertyGrid 控制項加入至指定的範圍。
AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String)	將 PropertyGrid 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddWebBrowser(ControlCollection, Range, String)	將 WebBrowser 控制項加入至指定的範圍。
AddWebBrowser(ControlCollection, Double, Double, Double, Double, String)	將 WebBrowser 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。

Word 的 Helper 方法

若要在執行階段將 Windows Form 控制項加入至文件，請使用 Document.Controls 屬性 (於應用程式層級專案中) 或 DocumentBase.Controls 屬性 (於文件層級專案中) 傳回的 ControlCollection 物件上提供的 Helper 方法。 每一個方法都是多載，所以您可以傳入 Range 或特定位置座標。 當藉由傳入 Range 以建立控制項時，控制項會以 InlineShape 的形式加入，放置在範圍的開始處。 您不能變加入與文字排列之更控制項的 Top 和 Left 屬性。 藉由傳入座標以建立控制項時，控制項會以浮動的 Shape 形式加入，放置在指定的位置。

注意事項
在目標為 .NET Framework 4 的 Word 增益集專案中，您必須先加入 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 組件的參考，才能存取 Helper 方法。

下表列出 Helper 方法，您可以使用這些方法，以程式設計方式將 Windows Form 控制項加入至 Word 文件。

Helper 方法	說明
AddButton(ControlCollection, Range, Single, Single, String)	將 Button 控制項加入至指定範圍的開頭。
AddButton(ControlCollection, Single, Single, Single, Single, String)	將 Button 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddLabel(ControlCollection, Range, Single, Single, String)	將 Label 控制項加入至指定範圍的開頭。
AddLabel(ControlCollection, Single, Single, Single, Single, String)	將 Label 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddLinkLabel(ControlCollection, Range, Single, Single, String)	將 LinkLabel 控制項加入至指定範圍的開頭。
AddLinkLabel(ControlCollection, Single, Single, Single, Single, String)	將 LinkLabel 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddTextBox(ControlCollection, Range, Single, Single, String)	將 TextBox 控制項加入至指定範圍的開頭。
AddTextBox(ControlCollection, Single, Single, Single, Single, String)	將 TextBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddCheckBox(ControlCollection, Range, Single, Single, String)	將 CheckBox 控制項加入至指定範圍的開頭。
AddCheckBox(ControlCollection, Single, Single, Single, Single, String)	將 CheckBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddRadioButton(ControlCollection, Range, Single, Single, String)	將 RadioButton 控制項加入至指定範圍的開頭。
AddRadioButton(ControlCollection, Single, Single, Single, Single, String)	將 RadioButton 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddPictureBox(ControlCollection, Range, Single, Single, String)	將 PictureBox 控制項加入至指定範圍的開頭。
AddPictureBox(ControlCollection, Single, Single, Single, Single, String)	將 PictureBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddCheckedListBox(ControlCollection, Range, Single, Single, String)	將 CheckedListBox 控制項加入至指定範圍的開頭。
AddCheckedListBox(ControlCollection, Single, Single, Single, Single, String)	將 CheckedListBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddComboBox(ControlCollection, Range, Single, Single, String)	將 ComboBox 控制項加入至指定範圍的開頭。
AddComboBox(ControlCollection, Single, Single, Single, Single, String)	將 ComboBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddListView(ControlCollection, Range, Single, Single, String)	將 ListView 控制項加入到指定的範圍，設定控制項的位置和大小。
AddListView(ControlCollection, Single, Single, Single, Single, String)	將 ListView 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddTreeView(ControlCollection, Range, Single, Single, String)	將 TreeView 控制項加入至指定範圍的開頭。
AddTreeView(ControlCollection, Single, Single, Single, Single, String)	將 TreeView 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddDateTimePicker(ControlCollection, Range, Single, Single, String)	將 DateTimePicker 控制項加入至指定範圍的開頭。
AddDateTimePicker(ControlCollection, Single, Single, Single, Single, String)	將 DateTimePicker 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddMonthCalendar(ControlCollection, Range, Single, Single, String)	將 MonthCalendar 控制項加入至指定範圍的開頭。
AddMonthCalendar(ControlCollection, Single, Single, Single, Single, String)	將 MonthCalendar 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddDomainUpDown(ControlCollection, Range, Single, Single, String)	將 DomainUpDown 控制項加入至指定範圍的開頭。
AddDomainUpDown(ControlCollection, Single, Single, Single, Single, String)	將 DomainUpDown 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddNumericUpDown(ControlCollection, Range, Single, Single, String)	將 NumericUpDown 控制項加入至指定範圍的開頭。
AddNumericUpDown(ControlCollection, Single, Single, Single, Single, String)	將 NumericUpDown 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddTrackBar(ControlCollection, Range, Single, Single, String)	將 TrackBar 控制項加入至指定範圍的開頭。
AddTrackBar(ControlCollection, Single, Single, Single, Single, String)	將 TrackBar 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddRichTextBox(ControlCollection, Range, Single, Single, String)	將 RichTextBox 控制項加入至指定範圍的開頭。
AddRichTextBox(ControlCollection, Single, Single, Single, Single, String)	將 RichTextBox 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddDataGridView(ControlCollection, Range, Single, Single, String)	將 DataGridView 控制項加入至指定範圍的開頭。
AddDataGridView(ControlCollection, Single, Single, Single, Single, String)	將 DataGridView 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddHScrollBar(ControlCollection, Range, Single, Single, String)	將 HScrollBar 控制項加入至指定範圍的開頭。
AddHScrollBar(ControlCollection, Single, Single, Single, Single, String)	將 HScrollBar 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddVScrollBar(ControlCollection, Range, Single, Single, String)	將 VScrollBar 控制項加入至指定範圍的開頭。
AddVScrollBar(ControlCollection, Single, Single, Single, Single, String)	將 VScrollBar 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddPropertyGrid(ControlCollection, Range, Single, Single, String)	將 PropertyGrid 控制項加入至指定範圍的開頭。
AddPropertyGrid(ControlCollection, Single, Single, Single, Single, String)	將 PropertyGrid 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。
AddWebBrowser(ControlCollection, Range, Single, Single, String)	將 WebBrowser 控制項加入至指定範圍的開頭。
AddWebBrowser(ControlCollection, Single, Single, Single, Single, String)	將 WebBrowser 控制項加入至指定位置，而非一段範圍內。 座標是以點來表示。

請參閱

概念

在執行階段將控制項加入至 Office 文件

Office 文件上的 Windows Form 控制項概觀

Office 文件上的 Windows Form 控制項限制

其他資源

Office 文件上的控制項