ControlCollection-Schnittstelle

Artikel
08/10/2011

Stellt eine Auflistung verwalteter Steuerelemente in einem Word-Dokument dar, das mit den Office-Entwicklungstools in Visual Studio angepasst wurde.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
<GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")> _
Public Interface ControlCollection _
    Inherits IEnumerable

[GuidAttribute("E1180F09-B903-4D03-8D30-2845219AEE2C")]
public interface ControlCollection : IEnumerable

Der ControlCollection-Typ macht die folgenden Member verfügbar.

Eigenschaften

	Name	Beschreibung
	Capacity	Ruft die Anzahl der Steuerelemente ab, die die ControlCollection enthalten kann, oder legt diese fest.
	Count	Ruft die Anzahl der Steuerelemente in der ControlCollection ab.
	Item[Int32]	Ruft das Steuerelement am angegebenen Index ab.
	Item[Object]	Ruft das angegebene Steuerelement ab.
	Item[String]	Ruft das Steuerelement mit dem angegebenen Namen ab.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	AddBookmark(Bookmark, String)	Fügt dem Dokument ein neues Microsoft.Office.Tools.Word.Bookmark-Steuerelement an der Position der angegebenen vorhandenen Microsoft.Office.Interop.Word.Bookmark hinzu.
	AddBookmark(Range, String)	Fügt dem Dokument im angegebenen Bereich ein neues Bookmark-Steuerelement hinzu.
	AddBuildingBlockGalleryContentControl(String)	Fügt bei der aktuellen Auswahl im Dokument ein neues BuildingBlockGalleryContentControl hinzu.
	AddBuildingBlockGalleryContentControl(ContentControl, String)	Fügt der Auflistung ein neues BuildingBlockGalleryContentControl hinzu.Das neue Steuerelement basiert auf einem systemeigenen Inhaltssteuerelement, das bereits im Dokument vorhanden ist.
	AddBuildingBlockGalleryContentControl(Range, String)	Fügt dem Dokument im angegebenen Bereich ein neues BuildingBlockGalleryContentControl-Element hinzu.
	AddComboBoxContentControl(String)	Fügt bei der aktuellen Auswahl im Dokument ein neues ComboBoxContentControl hinzu.
	AddComboBoxContentControl(ContentControl, String)	Fügt der Auflistung ein neues ComboBoxContentControl hinzu.Das neue Steuerelement basiert auf einem systemeigenen Inhaltssteuerelement, das bereits im Dokument vorhanden ist.
	AddComboBoxContentControl(Range, String)	Fügt dem Dokument im angegebenen Bereich ein neues ComboBoxContentControl-Element hinzu.
	AddContentControl(ContentControl, String)	Fügt ein neues ContentControl-Element hinzu, das auf einem systemeigenen Inhaltssteuerelement im Dokument basiert.
	AddContentControl(String, WdContentControlType)	Fügt bei der aktuellen Auswahl im Dokument ein neues ContentControl des angegebenen Typs hinzu.
	AddContentControl(Range, String, WdContentControlType)	Fügt im angegebenen Bereich im Dokument ein neues ContentControl des angegebenen Typs hinzu.
	AddControl(Control, Range, Single, Single, String)	Fügt der ControlCollection das angegebene Steuerelement mit der angegebenen Größe im angegebenen Bereich hinzu.
	AddControl(Control, Single, Single, Single, Single, String)	Fügt der ControlCollection das angegebene Steuerelement mit der angegebenen Größe an der angegebenen Position hinzu.
	AddDatePickerContentControl(String)	Fügt bei der aktuellen Auswahl im Dokument ein neues DatePickerContentControl hinzu.
	AddDatePickerContentControl(ContentControl, String)	Fügt der Auflistung ein neues DatePickerContentControl hinzu.Das neue Steuerelement basiert auf einem systemeigenen Inhaltssteuerelement, das bereits im Dokument vorhanden ist.
	AddDatePickerContentControl(Range, String)	Fügt dem Dokument im angegebenen Bereich ein neues DatePickerContentControl-Element hinzu.
	AddDropDownListContentControl(String)	Fügt bei der aktuellen Auswahl im Dokument ein neues DropDownListContentControl hinzu.
	AddDropDownListContentControl(ContentControl, String)	Fügt der Auflistung ein neues DropDownListContentControl hinzu.Das neue Steuerelement basiert auf einem systemeigenen Inhaltssteuerelement, das bereits im Dokument vorhanden ist.
	AddDropDownListContentControl(Range, String)	Fügt dem Dokument im angegebenen Bereich ein neues DropDownListContentControl-Element hinzu.
	AddGroupContentControl(String)	Fügt bei der aktuellen Auswahl im Dokument ein neues GroupContentControl hinzu.
	AddGroupContentControl(ContentControl, String)	Fügt ein neues GroupContentControl-Element hinzu, das auf einem systemeigenen Inhaltssteuerelement im Dokument basiert.
	AddGroupContentControl(Range, String)	Fügt dem Dokument im angegebenen Bereich ein neues GroupContentControl-Element hinzu.
	AddPictureContentControl(String)	Fügt bei der aktuellen Auswahl im Dokument ein neues PictureContentControl hinzu.
	AddPictureContentControl(ContentControl, String)	Fügt ein neues PictureContentControl-Element hinzu, das auf einem systemeigenen Inhaltssteuerelement im Dokument basiert.
	AddPictureContentControl(Range, String)	Fügt dem Dokument im angegebenen Bereich ein neues PictureContentControl-Element hinzu.
	AddPlainTextContentControl(String)	Fügt bei der aktuellen Auswahl im Dokument ein neues PlainTextContentControl hinzu.
	AddPlainTextContentControl(ContentControl, String)	Fügt ein neues PlainTextContentControl-Element hinzu, das auf einem systemeigenen Inhaltssteuerelement im Dokument basiert.
	AddPlainTextContentControl(Range, String)	Fügt dem Dokument im angegebenen Bereich ein neues PlainTextContentControl-Element hinzu.
	AddRichTextContentControl(String)	Fügt bei der aktuellen Auswahl im Dokument ein neues RichTextContentControl hinzu.
	AddRichTextContentControl(ContentControl, String)	Fügt ein neues RichTextContentControl-Element hinzu, das auf einem systemeigenen Inhaltssteuerelement im Dokument basiert.
	AddRichTextContentControl(Range, String)	Fügt dem Dokument im angegebenen Bereich ein neues RichTextContentControl-Element hinzu.
	Contains(Object)	Bestimmt, ob das angegebene Steuerelement ein Member der ControlCollection-Instanz ist.
	Contains(String)	Bestimmt, ob ein Steuerelement mit dem angegebenen Namen ein Member der ControlCollection-Instanz ist.
	GetEnumerator	Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Von IEnumerable geerbt.)
	GetInlineShapeForControl	Ruft das zugrunde liegende InlineShape für das angegebene Steuerelement ab.
	GetShapeForControl	Ruft das zugrunde liegende Shape für das angegebene Steuerelement ab.
	IndexOf(Object)	Sucht nach dem angegebenen Steuerelement und gibt den nullbasierten Index des ersten Vorkommens in der ControlCollection-Instanz zurück.
	IndexOf(String)	Sucht nach dem ersten Vorkommen eines Steuerelements mit dem angegebenen Namen in der ControlCollection-Instanz.
	Remove(Object)	Entfernt das angegebene Steuerelement aus der ControlCollection-Instanz.
	Remove(String)	Entfernt das angegebene Steuerelement aus der ControlCollection-Instanz.
	RemoveAt	Entfernt das Steuerelement am angegebenen Index in der ControlCollection-Instanz.

Zum Seitenanfang

Hinweise

Verwenden Sie die ControlCollection-Methoden und -Eigenschaften, um Steuerelemente in einem Word-Dokument zu verwalten. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

Um ein ControlCollection-Objekt in einem Projekt auf Dokumentebene abzurufen, verwenden Sie die Controls-Eigenschaft der ThisDocument-Klasse im Projekt. Um ein ControlCollection-Objekt in einem Projekt auf Anwendungsebene abzurufen, verwenden Sie die Controls-Eigenschaft eines Document-Hostelements, das Sie zur Laufzeit programmgesteuert erstellen. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

In der folgenden Tabelle wird gezeigt, wie Sie mit ControlCollection-Membern einige allgemeine Aufgaben ausführen können, die sich auf Steuerelemente in Dokumenten beziehen.

Aufgabe	Aktion
Fügen Sie dem Dokument ein Steuerelement hinzu.	Verwenden Sie eine der AddSteuerelementname-Methoden. Wenn Sie ein Inhaltssteuerelement hinzufügen möchten, verwenden Sie die AddContentControl-Methode.
Entfernen Sie ein Steuerelementen aus dem Dokument.	Verwenden Sie die Remove-Methode.
Bestimmen Sie, ob sich ein Steuerelement in der Auflistung befindet.	Übergeben Sie das Steuerelement oder seinen Namen an die Contains-Methode.
Ruft den Index eines Steuerelements in der Auflistung ab.	Übergeben Sie das Steuerelement oder seinen Namen an die IndexOf-Methode.
Rufen Sie ein Steuerelement aus der Auflistung ab.	Übergeben Sie den Index oder Namen des Steuerelements an die Item-Eigenschaft.

Tipp

Diese Schnittstelle wird von der Visual Studio Tools for Office-Laufzeit implementiert. Es ist nicht vorgesehen, dass der Typ direkt vom Code implementiert wird. Weitere Informationen finden Sie unter Übersicht über die Visual Studio Tools for Office-Laufzeit.

Verwendung

In dieser Dokumentation wird die Version dieses Typs beschrieben, der in Office-Projekten mit der Zielversion .NET Framework 4 verwendet wird. In Projekten mit der Zielversion .NET Framework 3.5 verfügt dieser Typ möglicherweise über unterschiedliche Member und die für diesen Typ bereitgestellten Codebeispiele funktionieren möglicherweise nicht. Dokumentation zu diesem Typ in Projekten mit der Zielversion .NET Framework 3.5 finden Sie im folgenden Verweisabschnitt in der Visual Studio 2008-Dokumentation: https://go.microsoft.com/fwlink/?LinkId=160658.

Siehe auch

Referenz

Microsoft.Office.Tools.Word-Namespace

Weitere Ressourcen

Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit

Hilfsmethoden für Hoststeuerelemente