Freigeben über

Verwenden von WPF-Steuerelementen in Office-Projektmappen

  • Artikel

Mit den Office-Entwicklungstools in Visual Studio erstellte Projektmappen sind zwar für das direkte Arbeiten mit Windows Forms-Steuerelementen ausgelegt, Sie können jedoch auch WPF-Steuerelemente in den Projektmappen verwenden. Windows Presentation Foundation (WPF) bietet eine Alternative zu Windows Forms für das Entwerfen von Benutzeroberflächen. WPF bietet mithilfe einer Markupsprache namens XAML (Extensible Application Markup Language) neue Techniken zum Integrieren von Benutzeroberflächen, Medien und Dokumenten. Weitere Informationen finden Sie unter WPF-Übersicht.

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

Jedes Benutzeroberflächenelement, das Windows Forms-Steuerelemente in einer Office-Projektmappe hosten kann, kann auch WPF-Steuerelemente hosten. Hierzu gehören:

  • 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 zur Entwurfszeit

Sie können Benutzeroberflächenelementen in Office-Projektmappen WPF-Steuerelemente nicht direkt 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 einem Benutzeroberflächenelement im 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 einWPF-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. Erstellen Sie das Projekt.

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

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

    Visual Studio erstellt automatisch ein ElementHost-Objekt, das das WPF-Benutzersteuerelement im Benutzeroberflächenelement hostet.

  7. Erstellen Sie das Projekt neu.

So fügen Sie einem Dokument oder einem 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 einWPF-Element User Control) hinzu.

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

  4. Erstellen Sie das Projekt.

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

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

  7. Ziehen Sie aus der Registerkarte ProjectName WPF User Controls der Toolbox das WPF-Benutzersteuerelement in den Designer.

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

  8. Schreiben Sie Code, der dem Dokument bzw. der Arbeitsmappe das Windows Forms-Benutzersteuerelement programmgesteuert hinzufügt. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

    Hinweis

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

  9. Erstellen Sie das Projekt neu.

Hosten von WPF-Steuerelementen mithilfe der ElementHost-Klasse

Visual Studio bietet Funktionen, die Sie beim Verwenden von Windows Forms-Steuerelementen in Office-Projektmappen unterstützen, aber es fehlen vergleichbare Funktionen für WPF-Steuerelemente. 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 bzw. -Formular und den WPF-Steuerelementen. Wenn Sie der Projektmappe zur Entwurfszeit WPF-Steuerelemente hinzufügen, generiert Visual Studio automatisch ein ElementHost-Objekt.

WPF-Ressourcen

Weitere Informationen zu Fragen über Architektur und Entwurf beim Hosten von WPF-Steuerelementen in Windows Forms-Steuerelementen und -Formularen finden Sie in den folgenden Themen:

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

Zugehöriger Inhalt