Freigeben über


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

Windows Forms-Steuerelemente stellen Objekte dar, mit denen Benutzer arbeiten können, um Daten einzugeben oder zu ändern.In Projekten auf Dokumentebene für Microsoft Office Excel und Microsoft Office Word können Sie dem Dokument oder der Arbeitsmappe im Projekt Windows Forms-Steuerelemente zur Entwurfszeit oder auch programmgesteuert zur Laufszeit hinzufügen.Sie können diese Steuerelemente jedem geöffneten Dokument oder Arbeitsblatt in einem Add-In auf Anwendungsebene für Excel oder Word zur Laufzeit programmgesteuert hinzufügen.

Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen von Windows Forms-Steuerelementen zu Office-Dokumenten.

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

Verwenden von Windows Forms-Steuerelementen

Sie können Windows Forms-Steuerelemente Dokumenten und benutzerdefinierbaren Benutzeroberflächenelementen (z. B. Aktionsbereiche, benutzerdefinierte Aufgabebereiche und Windows Forms) hinzufügen.In den meisten Fällen verhalten sich Windows Forms-Steuerelemente in Dokumenten genauso wie in diesen anderen Benutzeroberflächenelementen, es bestehen jedoch einige Unterschiede.Weitere Informationen finden Sie unter Einschränkungen für Windows Forms-Steuerelemente in Office-Dokumenten.

Die Entscheidung, ob Sie Windows Forms-Steuerelemente einem Dokument oder einem anderen Benutzeroberflächenelement hinzufügen, ist von verschiedenen Faktoren abhängig.Berücksichtigen Sie beim Entwerfen Ihrer Lösung die in der folgenden Tabelle beschriebenen Kriterien für die Verwendung von Windows Forms-Steuerelementen.

  • Dokument

    • Wenn Sie die Steuerelemente ständig anzeigen möchten.

    • Wenn Sie möchten, dass Benutzer Daten direkt im Dokument eingeben, beispielsweise in formularbasierte Dokumente, bei denen die Bearbeitungsoberfläche gesperrt ist.

    • Wenn die Steuerelemente an den Daten im Dokument ausgerichtet angezeigt werden sollen.Wenn Sie z. B. jeder Zeile eines Listenobjekts Schaltflächen hinzufügen, sollten diese an den einzelnen Listenelementen ausgerichtet sein.

  • Aktionsbereich oder benutzerdefinierter Aufgabenbereich

    • Wenn Sie dem Benutzer Kontextinformationen geben möchten.

    • Wenn Sie nur die Ergebnisse im Dokument anzeigen möchten, nicht die Abfrage-Steuerelemente und -daten.

    • Wenn Sie sicherstellen möchten, dass die Steuerelemente nicht mit dem Dokument gedruckt werden.

    • Wenn Sie dafür sorgen möchten, dass die Ansicht des Dokuments nicht von den Steuerelementen blockiert wird.

  • Windows Form

    • Wenn Sie die Größe der Benutzeroberfläche steuern möchten.

    • Wenn Sie verhindern möchten, dass Benutzer Steuerelemente ausblenden oder löschen.

    • Wenn der Benutzer Daten eingeben soll und Sie verhindern möchten, dass das Dokument vor Empfang der Eingabe anderweitig bearbeitet wird.

Programmgesteuertes Hinzufügen von Windows Forms-Steuerelementen

Sie können Word-Dokumenten und Excel-Arbeitsblättern zur Laufzeit Windows Forms-Steuerelemente hinzufügen.Visual Studio-Tools für Office-Laufzeit stellt Hilfsmethoden zum Hinzufügen der gängigsten Windows Forms-Steuerelemente bereit.Mit diesen Hilfsmethoden können Sie Office-Dokumenten schnell Steuerelemente hinzufügen und auf die Kombination aus Windows Forms-Steuerelementfunktionalität und Office-bezogener Funktionalität dieser Steuerelemente zugreifen.

Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

Verwenden von Windows Forms-Steuerelementen in Projekten auf Dokumentebene

Einige Aspekte der Verwendung von Windows Forms-Steuerelementen für Dokumente gelten nur für Projekte auf Dokumentebene, die es Ihnen ermöglichen, die Benutzeroberfläche Ihres Dokuments mit Visual Studio-Designer zu entwerfen.

0x6hstz2.collapse_all(de-de,VS.110).gifErstellen benutzerdefinierter Benutzersteuerelemente

Sie können ein Benutzersteuerelement dem Projekt und dann der Toolbox hinzufügen.Dann können Sie das Benutzersteuerelement dem Dokument hinzufügen, indem Sie es (wie ein Windows Forms-Steuerelement) direkt auf das Dokument ziehen.Bei der Erstellung von Benutzersteuerelementen sind einige Punkte zu berücksichtigen:

  • Erstellen Sie kein sealed-Benutzersteuerelement.Wenn Sie das Steuerelement in das Dokument ziehen, generiert Visual Studio eine vom Benutzersteuerelement abgeleitete Wrapperklasse, die das Benutzersteuerelement erweitert und seine Verwendung im Dokument unterstützt.Wenn das Benutzersteuerelement sealed ist, kann Visual Studio die Wrapperklasse nicht generieren.

  • Für Benutzersteuerelemente muss das ComVisibleAttribute-Attribut auf true festgelegt sein.Bei Benutzersteuerelementen, die in einem Office-Projekt erstellt werden, ist dieses Attribut standardmäßig auf true festgelegt. Bei Benutzersteuerelementen hingegen, die aus anderen Projekten stammen, ist dieses Attribut möglicherweise nicht auf true festgelegt.

  • Nachdem Sie dem Dokument ein Benutzersteuerelement hinzugefügt haben, dürfen Sie die UserControl-Klasse nicht umbenennen oder aus dem Projekt löschen.Wenn Sie ein Benutzersteuerelement umbenennen möchten, müssen Sie es zuerst aus dem Dokument löschen. Dann können Sie es umbenennen und erneut hinzufügen.

0x6hstz2.collapse_all(de-de,VS.110).gifAnordnen von Steuerelementen zur Entwurfszeit

Wenn Sie Word- und Excel-Dokumenten zur Entwurfszeit mehrere Steuerelemente hinzufügen, können Sie die Ausrichtung aller ausgewählten Steuerelemente in Visual Studio schnell mit den Symbolleisten Microsoft Office Word und Microsoft Office Excel festlegen.Diese Symbolleisten sind nur verfügbar, wenn ein Dokument oder Arbeitsblatt im Designer geöffnet ist.

Beim Auswählen mehrerer Steuerelemente im Designer können Sie diese mit den folgenden Schaltflächen auf diesen Symbolleisten anordnen:

  • Links ausrichten

  • Zentriert

  • Rechts ausrichten

  • Oben ausrichten

  • Mittig ausrichten

  • Unten ausrichten

  • Horizontalen Abstand angleichen

  • Vertikalen Abstand angleichen

HinweisHinweis

In Word-Projekten sind diese Schaltflächen nur verfügbar, wenn die ausgewählten Steuerelemente nicht am Text ausgerichtet sind.Standardmäßig werden Steuerelemente, die Sie dem Dokument zur Entwurfszeit hinzufügen, am Text ausgerichtet.

0x6hstz2.collapse_all(de-de,VS.110).gifVerhindern der Anzeige alter Daten beim Laden von Excel-Arbeitsmappen

Wenn Sie Dokumenten oder Arbeitsmappen zur Entwurfszeit Windows Forms-Steuerelemente hinzufügen, bleiben die Steuerelemente beim Schließen des Dokuments durch den Benutzer im Dokument erhalten.Steuerelemente, die Sie zur Entwurfszeit hinzufügen, werden auch als statische Steuerelemente bezeichnet.

Beim Öffnen einer Excel-Arbeitsmappe, die ein statisches Steuerelement enthält, wird in der Arbeitsmappe solange eine Bitmap des Steuerelements in einem ActiveX-Steuerelement angezeigt, bis der Anpassungscode ausgeführt und das tatsächliche Steuerelement geladen wird.Diese Bitmap wird von Excel erstellt und bei jedem Speichern der Arbeitsmappe in der Arbeitsmappe gespeichert.Das Steuerelement wird in der Bitmap so angezeigt, wie es zum Zeitpunkt der letzten Speicherung der Arbeitsmappe angezeigt wurde, einschließlich aller vom Steuerelement angezeigten Daten.Weitere Informationen zum ActiveX-Steuerelement, das Windows Forms-Steuerelemente und Bitmaps enthält, finden Sie unter Einschränkungen für Windows Forms-Steuerelemente in Office-Dokumenten.

Unter bestimmten Bedingungen wird der Code nicht geladen und nur die Bitmap angezeigt, beispielsweise wenn der Benutzer die Arbeitsmappe im Entwurfsmodus öffnet.Wenn der Benutzer die Arbeitsmappe auf einem Computer öffnet, auf dem Visual Studio-Tools für Office-Laufzeit nicht installiert ist, kann die Anpassung zum Laden der Steuerelemente nicht ausgeführt werden. Es wird daher nur die Bitmap des Steuerelements angezeigt.Sie sollten persönliche Informationen stets aus Steuerelementen in einer Arbeitsmappe entfernen, bevor Sie die Arbeitsmappe speichern und an andere Benutzer senden, damit Sie nicht versehentlich vertrauliche Informationen preisgeben.

0x6hstz2.collapse_all(de-de,VS.110).gifAbgleichen der Steuerelementgröße mit der Zellgröße in einem Excel-Arbeitsblatt

Sie können das Steuerelement so konfigurieren, dass dessen Größe automatisch bei Änderung der Größe der übergeordneten Zelle geändert wird.Weitere Informationen finden Sie unter Gewusst wie: Ändern der Größe von Steuerelementen innerhalb der Arbeitsblattzellen.

0x6hstz2.collapse_all(de-de,VS.110).gifHinzufügen von Komponenten, die von allen Arbeitsmappen freigegeben werden

Sie können Komponenten, die Sie für alle Arbeitsblätter freigeben möchten (z. B. DataSet), dem Arbeitsmappen-Designer anstelle den Arbeitsmappen hinzufügen.Die Komponente wird auf der Komponentenleiste angezeigt.

0x6hstz2.collapse_all(de-de,VS.110).gifFormel für das Einbetten von Steuerelementen in einem Excel-Arbeitsblatt

Wenn Sie in Excel ein Steuerelement auswählen, wird in der Bearbeitungsleiste=EMBED("WinForms.Control.Host","") angezeigt.Dieser Text ist notwendig und sollte nicht gelöscht werden.

0x6hstz2.collapse_all(de-de,VS.110).gifLayout -Format von Steuerelementen in einem Word-Dokument

Wenn Sie dem Word-Dokument in einem Projekt auf Dokumentebene mithilfe des Visual Studio Designers ein Steuerelement hinzufügen, wird das Steuerelement in den Textfluss eingefügt.Um den Layoutstil des Steuerelements zu ändern, klicken Sie mit der rechten Maustaste auf das Steuerelement und klicken dann auf Steuerelement formatieren.Wählen Sie auf der Seite Layout des Dialogfelds Objekt formatieren eine Umbruchart aus.

Wenn Sie einem Word-Dokument ein Steuerelement zur Laufzeit hinzufügen, können Sie den Layoutstil des neuen Elements festlegen, indem Sie verschiedene Add<Steuerelementklasse> Methodenüberladungen der Microsoft.Office.Tools.Word.ControlCollection-Klasse verwenden:

  • Um ein Steuerelement in den Textfluss einzufügen, verwenden Sie eine Überladung, die einen Range akzeptiert, der die Position des Steuerelements angibt.

  • Um ein Steuerelement als unverankerte Form einzufügen, verwenden Sie eine Überladung, die die linke und die obere Koordinate des Steuerelements akzeptiert.

Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

Wenn Sie eine Word-Vorlage im Visual Studio-Designer öffnen, sind nicht ausgerichtete Steuerelemente in der Vorlage möglicherweise nicht sichtbar, da die Vorlage von Visual Studio in der Normalansicht geöffnet wird.Um die Steuerelemente anzuzeigen, ändern Sie die Ansicht in Seitenlayout.

0x6hstz2.collapse_all(de-de,VS.110).gifSteuerelemente außerhalb des Haupttexts des Dokuments

Windows Forms-Steuerelemente werden in Kopf- oder Fußzeilen oder in einem Unterdokument nicht unterstützt.

0x6hstz2.collapse_all(de-de,VS.110).gifHinzufügen von Komponenten zur Entwurfszeit

Bestimmte Steuerelemente oder Komponenten sind im Dokument nicht sichtbar und werden stattdessen auf einer Komponentenleiste angezeigt.Visual Studio stellt eine Komponentenleiste für jedes Dokumentfenster bereit.Die Komponentenleiste wird nur auf dem Bildschirm angezeigt, sofern Komponenten im Dokument vorhanden sind.

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen von Windows Forms-Steuerelementen zu Office-Dokumenten

Gewusst wie: Ändern der Größe von Steuerelementen innerhalb der Arbeitsblattzellen

Gewusst wie: Ausblenden von Steuerelementen auf Arbeitsblättern beim Drucken

Exemplarische Vorgehensweise: Ändern der Arbeitsblattformatierung mithilfe von CheckBox-Steuerelementen

Exemplarische Vorgehensweise: Ändern der Dokumentformatierung mit CheckBox-Steuerelementen

Exemplarische Vorgehensweise: Anzeigen von Text in einem Textfeld in einem Arbeitsblatt mithilfe einer Schaltfläche

Exemplarische Vorgehensweise: Anzeigen von Text in einem Textfeld in einem Dokument mithilfe einer Schaltfläche

Exemplarische Vorgehensweise: Aktualisieren eines Diagramms in einem Dokument mithilfe von Optionsfeldern

Exemplarische Vorgehensweise: Aktualisieren eines Diagramms in einem Arbeitsblatt mithilfe von Optionsfeldern

Referenz

ControlCollection.Remove

ControlCollection.Remove

Konzepte

Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit

Übersicht über Hostelemente und Hoststeuerelemente

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

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

Weitere Ressourcen

Steuerelemente für Office-Dokumente

Aktionsbereichsübersicht

Windows Forms-Steuerelemente