Hilfsmethoden für Windows Forms-Steuerelemente

Mit Hilfsmethoden, die im Projekt verfügbar sind, können Sie einem Microsoft Office Word-Dokument und einer Microsoft Office Excel-Arbeitsmappe zur Laufzeit programmgesteuert Windows Forms-Steuerelemente hinzufügen. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und Anwendungsebene für die folgenden Anwendungen: Excel 2007 und Excel 2010, Word 2007 und Word 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

Hilfsmethoden für Excel

Um einem Arbeitsblatt zur Laufzeit Windows Forms-Steuerelemente hinzuzufügen, verwenden Sie Hilfsmethoden, die im von der Worksheet.Controls-Eigenschaft (in einem Projekt auf Anwendungsebene) oder der WorksheetBase.Controls-Eigenschaft (in einem Projekt auf Dokumentebene) zurückgegebenen ControlCollection-Objekt verfügbar sind. Jede Hilfsmethode ist überladen, d. h., Sie können entweder Range oder genaue Positionskoordinaten übergeben. Wenn Sie ein Steuerelement durch die Übergabe von Range erstellen, wird automatisch die Größe des Steuerelements angepasst, wenn die Größe der Zellen im Bereich geändert wird.

Tipp

In Excel-Add-In-Projekten, die auf .NET Framework 4 abzielen, müssen Sie einen Verweis auf die Assembly Microsoft.Office.Tools.Excel.v4.0.Utilities.dll hinzufügen, bevor Sie auf die Hilfsmethoden zugreifen können.

Die folgende Tabelle listet die Hilfsmethoden auf, mit denen Sie Excel-Arbeitsmappen programmgesteuert Windows Forms-Steuerelemente hinzufügen können.

Hilfsmethode	Beschreibung
AddButton(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein Button-Steuerelement hinzu.
AddButton(ControlCollection, Double, Double, Double, Double, String)	Fügt ein Button-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddLabel(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein Label-Steuerelement hinzu.
AddLabel(ControlCollection, Double, Double, Double, Double, String)	Fügt ein Label-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddLinkLabel(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein LinkLabel-Steuerelement hinzu.
AddLinkLabel(ControlCollection, Double, Double, Double, Double, String)	Fügt ein LinkLabel-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddTextBox(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein TextBox-Steuerelement hinzu.
AddTextBox(ControlCollection, Double, Double, Double, Double, String)	Fügt ein TextBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddCheckBox(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein CheckBox-Steuerelement hinzu.
AddCheckBox(ControlCollection, Double, Double, Double, Double, String)	Fügt ein CheckBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddRadioButton(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein RadioButton-Steuerelement hinzu.
AddRadioButton(ControlCollection, Double, Double, Double, Double, String)	Fügt ein RadioButton-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddPictureBox(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein PictureBox-Steuerelement hinzu.
AddPictureBox(ControlCollection, Double, Double, Double, Double, String)	Fügt ein PictureBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddCheckedListBox(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein CheckedListBox-Steuerelement hinzu.
AddCheckedListBox(ControlCollection, Double, Double, Double, Double, String)	Fügt ein CheckedListBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddComboBox(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein ComboBox-Steuerelement hinzu.
AddComboBox(ControlCollection, Double, Double, Double, Double, String)	Fügt ein ComboBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddListView(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein ListView-Steuerelement hinzu und legt dessen Position und Größe fest.
AddListView(ControlCollection, Double, Double, Double, Double, String)	Fügt ein ListView-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddTreeView(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein TreeView-Steuerelement hinzu.
AddTreeView(ControlCollection, Double, Double, Double, Double, String)	Fügt ein TreeView-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddDateTimePicker(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein DateTimePicker-Steuerelement hinzu.
AddDateTimePicker(ControlCollection, Double, Double, Double, Double, String)	Fügt ein DateTimePicker-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddMonthCalendar(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein MonthCalendar-Steuerelement hinzu.
AddMonthCalendar(ControlCollection, Double, Double, Double, Double, String)	Fügt ein MonthCalendar-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddDomainUpDown(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein DomainUpDown-Steuerelement hinzu.
AddDomainUpDown(ControlCollection, Double, Double, Double, Double, String)	Fügt ein DomainUpDown-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddNumericUpDown(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein NumericUpDown-Steuerelement hinzu.
AddNumericUpDown(ControlCollection, Double, Double, Double, Double, String)	Fügt ein NumericUpDown-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddTrackBar(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein TrackBar-Steuerelement hinzu.
AddTrackBar(ControlCollection, Double, Double, Double, Double, String)	Fügt ein TrackBar-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddRichTextBox(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein RichTextBox-Steuerelement hinzu.
AddRichTextBox(ControlCollection, Double, Double, Double, Double, String)	Fügt ein RichTextBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddDataGridView(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein DataGridView-Steuerelement hinzu.
AddDataGridView(ControlCollection, Double, Double, Double, Double, String)	Fügt ein DataGridView-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddHScrollBar(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein HScrollBar-Steuerelement hinzu.
AddHScrollBar(ControlCollection, Double, Double, Double, Double, String)	Fügt ein HScrollBar-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddVScrollBar(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein VScrollBar-Steuerelement hinzu.
AddVScrollBar(ControlCollection, Double, Double, Double, Double, String)	Fügt ein VScrollBar-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddPropertyGrid(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein PropertyGrid-Steuerelement hinzu.
AddPropertyGrid(ControlCollection, Double, Double, Double, Double, String)	Fügt ein PropertyGrid-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddWebBrowser(ControlCollection, Range, String)	Fügt dem angegebenen Bereich ein WebBrowser-Steuerelement hinzu.
AddWebBrowser(ControlCollection, Double, Double, Double, Double, String)	Fügt ein WebBrowser-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".

Hilfsmethoden für Word

Um einem Dokument zur Laufzeit Windows Forms-Steuerelemente hinzuzufügen, verwenden Sie Hilfsmethoden, die im von der Document.Controls-Eigenschaft (in einem Projekt auf Anwendungsebene) oder der DocumentBase.Controls-Eigenschaft (in einem Projekt auf Dokumentebene) zurückgegebenen ControlCollection-Objekt verfügbar sind. Jede Methode ist überladen, d. h., Sie können entweder Range oder genaue Positionskoordinaten übergeben. Wenn Sie beim Erstellen eines Steuerelements einen Range übergeben, wird das Steuerelement als InlineShape am Anfang des Bereichs hinzugefügt. Sie können die Top-Eigenschaft und die Left-Eigenschaft von Steuerelementen, die in den Textfluss eingefügt werden, nicht ändern. Wenn Sie ein Steuerelement durch die Übergabe von Koordinaten erstellen, wird das Steuerelement als nicht verankerte Shape an der angegebenen Position hinzugefügt.

Tipp

In Word-Add-In-Projekten, die auf .NET Framework 4 abzielen, müssen Sie einen Verweis auf die Assembly Microsoft.Office.Tools.Word.v4.0.Utilities.dll hinzufügen, bevor Sie auf die Hilfsmethoden zugreifen können.

Die folgende Tabelle listet die Hilfsmethoden auf, mit denen Sie Word-Dokumenten programmgesteuert Windows Forms-Steuerelemente hinzufügen können.

Hilfsmethode	Beschreibung
AddButton(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein Button-Steuerelement hinzu.
AddButton(ControlCollection, Single, Single, Single, Single, String)	Fügt ein Button-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddLabel(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein Label-Steuerelement hinzu.
AddLabel(ControlCollection, Single, Single, Single, Single, String)	Fügt ein Label-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddLinkLabel(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein LinkLabel-Steuerelement hinzu.
AddLinkLabel(ControlCollection, Single, Single, Single, Single, String)	Fügt ein LinkLabel-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddTextBox(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein TextBox-Steuerelement hinzu.
AddTextBox(ControlCollection, Single, Single, Single, Single, String)	Fügt ein TextBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddCheckBox(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein CheckBox-Steuerelement hinzu.
AddCheckBox(ControlCollection, Single, Single, Single, Single, String)	Fügt ein CheckBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddRadioButton(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein RadioButton-Steuerelement hinzu.
AddRadioButton(ControlCollection, Single, Single, Single, Single, String)	Fügt ein RadioButton-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddPictureBox(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein PictureBox-Steuerelement hinzu.
AddPictureBox(ControlCollection, Single, Single, Single, Single, String)	Fügt ein PictureBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddCheckedListBox(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein CheckedListBox-Steuerelement hinzu.
AddCheckedListBox(ControlCollection, Single, Single, Single, Single, String)	Fügt ein CheckedListBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddComboBox(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein ComboBox-Steuerelement hinzu.
AddComboBox(ControlCollection, Single, Single, Single, Single, String)	Fügt ein ComboBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddListView(ControlCollection, Range, Single, Single, String)	Fügt dem angegebenen Bereich ein ListView-Steuerelement hinzu und legt dessen Position und Größe fest.
AddListView(ControlCollection, Single, Single, Single, Single, String)	Fügt ein ListView-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddTreeView(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein TreeView-Steuerelement hinzu.
AddTreeView(ControlCollection, Single, Single, Single, Single, String)	Fügt ein TreeView-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddDateTimePicker(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein DateTimePicker-Steuerelement hinzu.
AddDateTimePicker(ControlCollection, Single, Single, Single, Single, String)	Fügt ein DateTimePicker-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddMonthCalendar(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein MonthCalendar-Steuerelement hinzu.
AddMonthCalendar(ControlCollection, Single, Single, Single, Single, String)	Fügt ein MonthCalendar-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddDomainUpDown(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein DomainUpDown-Steuerelement hinzu.
AddDomainUpDown(ControlCollection, Single, Single, Single, Single, String)	Fügt ein DomainUpDown-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddNumericUpDown(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein NumericUpDown-Steuerelement hinzu.
AddNumericUpDown(ControlCollection, Single, Single, Single, Single, String)	Fügt ein NumericUpDown-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddTrackBar(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein TrackBar-Steuerelement hinzu.
AddTrackBar(ControlCollection, Single, Single, Single, Single, String)	Fügt ein TrackBar-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddRichTextBox(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein RichTextBox-Steuerelement hinzu.
AddRichTextBox(ControlCollection, Single, Single, Single, Single, String)	Fügt ein RichTextBox-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddDataGridView(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein DataGridView-Steuerelement hinzu.
AddDataGridView(ControlCollection, Single, Single, Single, Single, String)	Fügt ein DataGridView-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddHScrollBar(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein HScrollBar-Steuerelement hinzu.
AddHScrollBar(ControlCollection, Single, Single, Single, Single, String)	Fügt ein HScrollBar-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddVScrollBar(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein VScrollBar-Steuerelement hinzu.
AddVScrollBar(ControlCollection, Single, Single, Single, Single, String)	Fügt ein VScrollBar-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddPropertyGrid(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein PropertyGrid-Steuerelement hinzu.
AddPropertyGrid(ControlCollection, Single, Single, Single, Single, String)	Fügt ein PropertyGrid-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".
AddWebBrowser(ControlCollection, Range, Single, Single, String)	Fügt am Anfang des angegebenen Bereichs ein WebBrowser-Steuerelement hinzu.
AddWebBrowser(ControlCollection, Single, Single, Single, Single, String)	Fügt ein WebBrowser-Steuerelement statt in einem Bereich an der angegebenen Position hinzu. Die Maßeinheit der Koordinaten ist "Punkt".

Siehe auch

Konzepte

Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit

Übersicht über Windows Forms-Steuerelemente in Office-Dokumenten

Einschränkungen für Windows Forms-Steuerelemente in Office-Dokumenten

Weitere Ressourcen

Steuerelemente für Office-Dokumente