Freigeben über

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

Windows Forms-Steuerelemente sind Objekte, mit denen Benutzer interagieren können, um Daten einzugeben oder zu bearbeiten. 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 oder diese Steuerelemente programmgesteuert zur Laufzeit 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 So fügen Sie Windows Forms-Steuerelemente zu Office-Dokumenten hinzu.

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 Funktionen verfügbar nach Office-Anwendung und Projekttyp.

Verwenden von Windows Forms-Steuerelementen

Sie können Windows Forms-Steuerelemente zu Dokumenten hinzufügen und anpassbare Benutzeroberflächenelemente, einschließlich Aktionsbereiche, benutzerdefinierte Aufgabenbereiche und Windows Forms, hinzufügen. Windows Forms-Steuerelemente weisen in der Regel das gleiche Verhalten auf Dokumenten wie auf diesen anderen UI-Elementen auf, aber es gibt einige Unterschiede. Weitere Informationen finden Sie unter Einschränkungen von Windows Forms-Steuerelementen für Office-Dokumente.

Die Entscheidung, ob Windows Forms-Steuerelemente zu einem Dokument oder einem anderen UI-Element hinzugefügt werden sollen, hängt von mehreren Faktoren ab. Berücksichtigen Sie beim Entwerfen der Benutzeroberfläche Ihrer Lösung die Verwendung von Windows Forms-Steuerelementen, wie in der folgenden Tabelle beschrieben.

In einem Dokument.

  • Wenn Sie die Steuerelemente 100% der Zeit anzeigen möchten.

  • Wenn Benutzer Daten direkt in das Dokument eingeben möchten, z. B. in formularbasierte Dokumente, in denen die Bearbeitungsoberfläche gesperrt ist.

  • Wenn die Steuerelemente in Übereinstimmung mit den Daten im Dokument angezeigt werden sollen. Wenn Sie z. B. Schaltflächen zu jeder Zeile eines Listenobjekts hinzufügen, möchten Sie diese mit jedem Listenelement in Einklang bringen.

Im Aktionsbereich oder in einem benutzerdefinierten Aufgabenbereich.

  • Wenn Sie dem Benutzer kontextbezogene Informationen bereitstellen möchten.

  • Wenn im Dokument nur die Ergebnisse angezeigt werden sollen und nicht die Steuerelemente und Daten der Abfrage.

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

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

Auf einem Windows-Formular.

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

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

  • Wenn Sie Eingaben vom Benutzer erhalten möchten, und verhindern Sie, dass der Benutzer etwas im Dokument ausführt, bis die Eingabe empfangen wird.

Programmgesteuertes Hinzufügen von Windows Forms-Steuerelementen

Sie können Zur Laufzeit Windows Forms-Steuerelemente zu Word-Dokumenten und Excel-Arbeitsblättern hinzufügen. Die Visual Studio Tools für Office-Laufzeit bietet Hilfsmethoden zum Hinzufügen der am häufigsten verwendeten Windows Forms-Steuerelemente. Mit diesen Hilfsmethoden können Sie Ihrem Office-Dokument schnell Steuerelemente hinzufügen und auf die kombinierten Windows Forms-Steuerelementfunktionen und office-bezogene Funktionen dieser Steuerelemente zugreifen.

Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten während der Ausführung.

Verwenden von Windows Forms-Steuerelementen in Projekten auf Dokumentebene

Einige Aspekte der Verwendung von Windows Forms-Steuerelementen für Dokumente sind einzigartig für Projekte auf Dokumentebene, mit denen Sie die Benutzeroberfläche Ihres Dokuments mithilfe des Visual Studio-Designers entwerfen können.

Erstellen von benutzerdefinierten Benutzersteuerelementen

Sie können Ihrem Projekt ein Benutzersteuerelement hinzufügen und es dann der Toolbox hinzufügen. Anschließend können Sie das Benutzersteuerelement auf die gleiche Weise direkt in Ihr Dokument ziehen, wie Sie ihrem Dokument ein Windows Forms-Steuerelement hinzufügen würden. Beachten Sie beim Erstellen von Benutzersteuerelementen einige Punkte:

  • Erstellen Sie kein versiegeltes Benutzersteuerelement. Wenn Sie das Steuerelement in Ihr Dokument ziehen, generiert Visual Studio eine vom Benutzersteuerelement abgeleitete Wrapperklasse, um es zu erweitern und die Verwendung im Dokument zu unterstützen. Wenn das Benutzersteuerelement versiegelt ist, kann Visual Studio die Wrapperklasse nicht generieren.

  • Benutzersteuerelemente müssen das ComVisibleAttribute Attribut auf "true" festgelegt haben. Benutzersteuerelemente, die in einem Office-Projekt erstellt wurden, haben dieses Attribut standardmäßig auf "true " festgelegt, aber Benutzersteuerelemente, die Teil von externen Projekten sind, haben dieses Attribut möglicherweise nicht auf "true" festgelegt.

  • Nachdem Sie dem Dokument ein Benutzersteuerelement hinzugefügt haben, benennen oder löschen Sie die UserControl-Klasse nicht aus dem Projekt. Wenn Sie den Namen eines Benutzersteuerelements ändern müssen, müssen Sie es zuerst aus dem Dokument löschen und dann erneut hinzufügen, nachdem der Name geändert wurde.

Anordnen von Steuerelementen während der Entwurfsphase

Wenn Sie Ihren Word- und Excel-Dokumenten zur Entwurfszeit mehrere Steuerelemente hinzufügen, können Sie schnell die Ausrichtung aller ausgewählten Steuerelemente mithilfe der Symbolleisten von Microsoft Office Word und Microsoft Office Excel in Visual Studio 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 folgenden Schaltflächen auf diesen Symbolleisten verwenden, um die Steuerelemente anzuordnen:

  • Linksbündig ausrichten

  • Zentren ausrichten

  • Rechte ausrichten

  • Oben ausrichten

  • Mittelpunkte ausrichten

  • Unten ausrichten

  • Horizontalen Abstand angleichen

  • Vertikalen Abstand angleichen

Hinweis

In Word-Projekten sind diese Schaltflächen nur aktiviert, wenn sich die ausgewählten Steuerelemente nicht in Zeile mit Text befinden. Standardmäßig befinden sich Steuerelemente, die Sie dem Dokument während der Entwurfsphase hinzufügen, innerhalb des Textes.

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

Wenn Sie Windows Forms-Steuerelemente zu Dokumenten oder Arbeitsblättern zur Entwurfszeit hinzufügen, bleiben die Steuerelemente im Dokument, wenn der Benutzer das Dokument schließt. Steuerelemente, die zur Entwurfszeit hinzugefügt werden, werden auch als statische Steuerelemente bezeichnet.

Wenn eine Excel-Arbeitsmappe mit statischen Steuerelementen geöffnet wird, zeigt die Arbeitsmappe eine Bitmap des Steuerelements in einem ActiveX-Steuerelement an, bis der Anpassungscode ausgeführt und das eigentliche Steuerelement geladen wird. Excel erstellt diese Bitmap und speichert sie immer dann in der Arbeitsmappe, wenn die Arbeitsmappe gespeichert wird. Die Bitmap zeigt das Steuerelement so an, wie es beim letzten Speichern der Arbeitsmappe angezeigt wurde, einschließlich aller Daten, die das Steuerelement anzeigte. 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 nur die Bitmap wird angezeigt, z. B. 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 sind, kann die Anpassung nicht ausgeführt werden, um die Steuerelemente zu laden. Daher ist nur die Bitmap des Steuerelements sichtbar. Sie sollten persönliche Informationen immer aus Steuerelementen in Arbeitsmappen entfernen, bevor Sie die Arbeitsmappe speichern und an einen anderen Benutzer senden, um sicherzustellen, dass Ihre persönlichen Informationen nicht versehentlich offengelegt werden.

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

Sie können festlegen, dass die Größe des Steuerelements automatisch geändert wird, wenn die Größe der übergeordneten Zelle geändert wird. Weitere Informationen finden Sie unter So ändern Sie die Größe von Steuerelementen innerhalb von Arbeitsblattzellen.

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

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

Formel zum Einbetten von Steuerelementen in ein Excel-Arbeitsblatt

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

Layoutformat von Steuerelementen in einem Word-Dokument

Wenn Sie mithilfe des Visual Studio-Designers ein Steuerelement zu einem Projekt auf Dokumentebene im Word-Dokument hinzufügen, wird das Steuerelement inline mit dem Text hinzugefügt. Wenn Sie das Layout des Steuerelements ändern möchten, klicken Sie mit der rechten Maustaste auf das Steuerelement, und klicken Sie dann auf "Steuerelement formatieren". Wählen Sie auf der Seite "Layout " des Dialogfelds " Objekt formatieren " ein Umbruchformat 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 angeben:

  • Wenn Sie das Steuerelement in Zeile mit Text hinzufügen möchten, verwenden Sie eine Überladung, die einen Range Wert akzeptiert, der die Position des Steuerelements angibt.

  • Um das Steuerelement als schwebende Form hinzuzufügen, verwenden Sie eine Überladungsmethode, die die linken und oberen Koordinaten des Steuerelements akzeptiert.

    Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten während der Ausführung.

    Wenn Sie eine Word-Vorlage im Visual Studio-Designer öffnen, sind nicht inlinebasierte Steuerelemente in der Vorlage möglicherweise nicht sichtbar, da Visual Studio die Vorlage in der Normalansicht öffnet. Wenn Sie die Steuerelemente anzeigen möchten, ändern Sie die Ansicht in "Drucklayout".

Steuerelemente außerhalb des Hauptdokumenttexts

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

Hinzufügen von Komponenten zur Entwurfszeit

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

Verwandte Inhalte

  • Last updated on