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

  • Artikel

Windows Forms-Steuerelemente sind Objekte, 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 in Ihrem Projekt zur Entwurfszeit Windows Forms-Steuerelemente hinzufügen, Sie können diese Steuerelemente aber auch zur Laufzeit programmgesteuert hinzufügen. Sie können diese Steuerelemente programmgesteuert zu jedem geöffneten Dokument oder Arbeitsblatt zur Laufzeit in einem VSTO-Add-In für Excel oder Word hinzufügen.

Weitere Informationen finden Sie unter How to: Add Windows Forms controls to Office documents.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte für Excel und Word. Weitere Informationen finden Sie unter features available by Office-App lication and project type.

Verwenden von Windows Forms-Steuerelementen

Sie können Windows Forms-Steuerelemente zu Dokumenten und anpassbbaren Benutzeroberflächenelementen (etwa Aktionsbereiche, benutzerdefinierte Aufgabenbereiche 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 gibt aber auch einige Unterschiede. Weitere Informationen finden Sie unter Einschränkungen von Windows Forms-Steuerelementen für Office-Dokumente.

Die Entscheidung, ob Sie Windows Forms-Steuerelemente einem Dokument oder einem anderen Benutzeroberflächenelement hinzufügen, ist von verschiedenen Faktoren abhängig. Wenn Sie die Benutzeroberfläche Ihrer Lösung entwerfen, sollten Sie die Nutzung von Windows Forms-Steuerelemente entsprechend den Beschreibungen in der folgenden Tabelle berücksichtigen.

Auf einem Dokument.

  • Wenn Sie möchten, dass die Steuerelemente immer angezeigt werden.

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

  • Wenn Sie möchten, dass die Steuerelemente an den Daten ausgerichtet im Dokument angezeigt werden sollen. Wenn Sie beispielsweise jeder Zeile eines Listenobjekts Schaltflächen hinzufügen, sollten diese an dem jeweiligen Listenelement ausgerichtet sein.

Im Aktionsbereich oder in einem benutzerdefinierten Aufgabenbereich.

  • Wenn Sie dem Benutzer Kontextinformationen bereitstellen möchten.

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

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

  • Wenn Sie sicherstellen möchten, dass die Steuerelemente nicht die Ansicht des Dokuments beeinträchtigen.

Auf einem 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 können.

  • 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. Die Visual Studio-Tools für Office-Runtime stellt Hilfsmethoden zum Hinzufügen der am häufigsten verwendeten Windows Forms-Steuerelemente bereit. Mit diesen Hilfsmethoden können Sie Office-Dokumenten schnell Steuerelemente hinzufügen und die Kombination aus Windows Forms-Steuerelementfunktionalität und Office-bezogener Funktionalität dieser Steuerelemente nutzen.

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 in Dokumenten gelten nur für Projekte auf Dokumentebene, die es Ihnen ermöglichen, die Benutzeroberfläche Ihres Dokuments mit Visual Studio-Designer zu entwerfen.

Erstellen benutzerdefinierter Benutzersteuerelemente

Sie können Ihrem Projekt ein Benutzersteuerelement hinzufügen und das Steuerelement dann der Toolboxhinzufügen. Danach können Sie das Benutzersteuerelement direkt in der gleichen Weise auf das Dokument ziehen, in der Sie einem Dokument ein Windows Forms-Steuerelement hinzufügen. Es gibt einige Punkte zu beachten, wenn Sie Benutzersteuerelemente erstellen:

  • Erstellen Sie kein sealed Benutzersteuerelement. Wenn Sie das Steuerelement auf ein Dokument ziehen, generiert Visual Studio eine Wrapperklasse, die aus dem Benutzersteuerelement abgeleitet wird, um das Steuerelement zu erweitern und seine Verwendung auf dem Dokument zu unterstützen. Wenn das Benutzersteuerelement sealedist, kann Visual Studio die Wrapperklasse nicht generieren.

  • Für Benutzersteuerelemente muss das ComVisibleAttribute -Attribut auf true. Bei Benutzersteuerelementen, die in einem Office-Projekt erstellt werden, ist dieses Attribut standardmäßig auf true festgelegt, aber bei Benutzersteuerelementen, die zu externen Projekten gehören, ist dieses Attribut möglicherweise nicht auf truefestgelegt.

  • Nachdem Sie dem Dokument ein Benutzersteuerelement hinzugefügt haben, dürfen Sie die UserControl -Klasse weder umbenennen noch aus dem Projekt löschen. Müssen Sie den Namen eines Benutzersteuerelements ändern, müssen Sie es zunächst aus dem Dokument löschen. Danach können Sie es, sobald der Name geändert wurde, erneut hinzufügen.

Anordnen 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.

Wenn Sie mehrere Steuerelemente im Designer auswählen, können Sie die Steuerelemente mit den folgenden Schaltflächen auf diesen Symbolleisten anordnen:

  • Nach links ausrichten

  • Zentriert

  • Nach rechts ausrichten

  • Nach oben ausrichten

  • Mittig ausrichten

  • Nach unten ausrichten

  • Horizontalen Abstand ausgleichen

  • Vertikalen Abstand ausgleichen

Hinweis

In Word-Projekten sind diese Schaltflächen nur aktiviert, 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.

Verhindern, dass alte Daten während des Ladens in Excel-Arbeitsmappen angezeigt werden

Wenn Sie Dokumenten oder Arbeitsmappen zur Entwurfszeit Windows Forms-Steuerelemente hinzufügen, verbleiben die Steuerelemente im Dokument, wenn der Benutzer das Dokument schließt. Steuerelemente, die zur Entwurfszeit hinzufügt wurden, werden auch als statischeSteuerelemente bezeichnet.

Wird eine Excel-Arbeitsmappe geöffnet, 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 von Windows Forms-Steuerelementen in Office-Dokumenten.

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

Anpassen der Steuerelementgröße an die Zellengröße auf einem Excel-Arbeitsblatt

Sie können ein Steuerelement so konfigurieren, dass dessen Größe automatisch bei Änderung der Größe der übergeordneten Zelle geändert wird. Weitere Informationen finden Sie unter How to: Resize controls within worksheet cells.

Hinzufügen von Komponenten, die von allen Arbeitsblättern gemeinsam verwendet werden

Sie können Komponenten, die auf allen Arbeitsblättern nutzbar sein sollen (etwa ein DataSet), dem Arbeitsmappen-Designer hinzufügen, statt sie den Arbeitsblättern hinzuzufügen. Die Komponente wird auf der Komponentenleiste angezeigt.

Formel zum Einbetten von Steuerelementen in ein Excel-Arbeitsblatt

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

Layoutformat von Steuerelementen in einem Word-Dokument

Wenn Sie einem 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 eines Steuerelements zu ändern, klicken Sie mit der rechten Maustaste auf das Steuerelement, und klicken Sie dann auf Steuerelement formatieren. Wählen Sie im Dialogfeld Objekt formatieren auf der Seite Layout eine Umbruchart aus.

Wenn Sie einem Word-Dokument zur Laufzeit ein Steuerelement hinzufügen, können Sie das Layoutformat des neuen Steuerelements mithilfe verschiedener Add<Methodenüberladungen der ControlCollection Steuerelementklasse> angeben:

  • Um ein Steuerelement in den Textfluss einzufügen, verwenden Sie eine Überladung, die einen Bereich ( 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 Visual Studio die Vorlage in der Ansicht Normal öffnet. Damit die Steuerelemente angezeigt werden, ändern Sie die Ansicht in Seitenlayout.

Steuerelemente außerhalb des Standard Dokumenttexts

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

Hinzufügen von Komponenten zur Entwurfszeit

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

Zugehöriger Inhalt