Freigeben über

Verwenden von WPF-Steuerelementen in Office-Lösungen

Obwohl Lösungen, die mit den Office-Entwicklungstools in Visual Studio erstellt wurden, für die direkte Arbeit mit Windows Forms-Steuerelementen konzipiert sind, können Sie auch WPF-Steuerelemente in Ihren Lösungen verwenden. Windows Presentation Foundation (WPF) ist eine Alternative zu Windows Forms zum Entwerfen von Benutzeroberflächen. WPF verwendet eine Markupsprache namens Extensible Application Markup Language (XAML), um neue Techniken für die Integration von UI, Medien und Dokumenten bereitzustellen. Weitere Informationen finden Sie in der WPF-Übersicht.

Gilt für: Die Informationen in diesem Thema gelten für Projekte auf Dokumentebene und VSTO-Add-In-Projekte. Siehe Verfügbare Features nach Office-Anwendung und Projekttyp.

Jedes UI-Element, das Windows Forms-Steuerelemente in einer Office-Lösung hosten kann, kann auch WPF-Steuerelemente hosten. Dazu gehören die folgenden Elemente:

  • Dokumente und Arbeitsblätter in Anpassungen auf Dokumentebene.

  • Aktionsbereiche in Anpassungen auf Dokumentebene.

  • Benutzerdefinierte Aufgabenbereiche in VSTO-Add-Ins.

  • Formularbereiche in VSTO-Add-Ins für Outlook.

Hinzufügen von WPF-Steuerelementen zu Office-Projekten während der Entwurfszeit

Sie können WPF-Steuerelemente nicht direkt zu UI-Elementen in Office-Lösungen hinzufügen. Fügen Sie ihrem Projekt stattdessen ein WPF-Element (User Control) hinzu, und verwenden Sie es als Entwurfsoberfläche für WPF-Steuerelemente. Fügen Sie dann das WPF-Benutzersteuerelement zu einem UI-Element in Ihrem Projekt hinzu.

So fügen Sie einem Aktionsbereich, einem benutzerdefinierten Aufgabenbereich oder einem Formularbereich WPF-Steuerelemente hinzu

  1. Öffnen Sie ein Projekt, dem Sie einen benutzerdefinierten Aufgabenbereich, einen Aktionsbereich oder einen Formularbereich hinzufügen möchten.

  2. Fügen Sie ihrem Projekt ein WPF-Element (User Control) hinzu.

  3. Fügen Sie aus der Toolbox WPF-Steuerelemente zur Entwurfsoberfläche des WPF-Benutzersteuerelements hinzu.

    Wenn der WPF-Benutzersteuerelement-Designer geöffnet ist, enthält die Toolbox standardmäßig nur WPF-Steuerelemente.

  4. Projekt erstellen.

  5. Fügen Sie Ihrem Projekt einen Aktionsbereich, einen Formularbereich oder einen benutzerdefinierten Aufgabenbereich hinzu:

  6. Ziehen Sie das WPF-Benutzersteuerelement aus der Registerkarte ProjectNameWPF-Benutzersteuerelemente der Toolbox in den Designer für den Aktionsbereich, Formularbereich oder benutzerdefinierten Aufgabenbereich.

    Visual Studio erstellt automatisch ein ElementHost Objekt, das das WPF-Benutzersteuerelement im UI-Element hosten soll.

  7. Erstellen Sie das Projekt neu.

So fügen Sie einem Dokument oder Arbeitsblatt in einem Projekt auf Dokumentebene WPF-Steuerelemente hinzu

  1. Öffnen Sie ein Projekt auf Dokumentebene für Word oder Excel.

  2. Fügen Sie ihrem Projekt ein WPF-Element (User Control) hinzu.

  3. Fügen Sie aus der Toolbox WPF-Steuerelemente zur Entwurfsoberfläche des WPF-Benutzersteuerelements hinzu.

  4. Projekt erstellen.

  5. Fügen Sie dem Projekt ein Benutzersteuerungselement (d. h. ein Windows Forms-Benutzersteuerelement ) hinzu.

  6. Öffnen Sie den Designer für das Windows Forms-Benutzersteuerelement.

  7. Ziehen Sie auf der Registerkarte "ProjectNameWPF-Benutzersteuerelemente " der Toolbox das WPF-Benutzersteuerelement in den Designer.

    Visual Studio erstellt automatisch ein ElementHost Objekt, das das WPF-Benutzersteuerelement im Windows Forms-Benutzersteuerelement hostt.

  8. Schreiben Sie Code, der dem Dokument oder der Arbeitsmappe programmgesteuert das Windows Forms-Benutzersteuerelement hinzufügt. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten während der Ausführung.

    Hinweis

    Sie können das Windows Forms-Benutzersteuerelement nicht auf das Dokument oder arbeitsblatt im Designer ziehen.

  9. Erstellen Sie das Projekt neu.

Hosten von WPF-Steuerelementen mithilfe der ElementHost-Klasse

Visual Studio bietet Features, die Ihnen bei der Verwendung von Windows Forms-Steuerelementen in Ihren Office-Lösungen helfen, aber keine ähnlichen Features für WPF-Steuerelemente bieten. Sie können beispielsweise Windows Forms-Steuerelemente zu Dokumenten und Arbeitsblättern zur Entwurfszeit hinzufügen, indem Sie Steuerelemente aus der Toolbox oder zur Laufzeit mithilfe von Hilfsmethoden ziehen. Diese Tools sind jedoch für WPF-Steuerelemente nicht verfügbar.

WPF-Steuerelemente verwenden die ElementHost Klasse als Integrationsebene zwischen einem Windows Forms-Steuerelement oder -Formular und den WPF-Steuerelementen. Wenn Sie Ihrer Lösung zur Entwurfszeit WPF-Steuerelemente hinzufügen, generiert Visual Studio automatisch ein ElementHost Objekt für Sie.

WPF-Ressourcen

Weitere Informationen zu Architektur- und Entwurfsproblemen für das Hosten von WPF-Steuerelementen in Windows Forms-Steuerelementen und -Formularen finden Sie in den folgenden Themen:

Weitere Informationen zum Hinzufügen von WPF-Steuerelementen zu Windows Forms-Steuerelementen und Formularen in Visual Studio zur Entwurfszeit finden Sie in den folgenden Themen:

Verwandte Inhalte

  • Last updated on