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 Einführung in WPF.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und Anwendungsebene für Microsoft Office 2010 und 2007 Microsoft Office System. Weitere Informationen finden Sie unter 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. Dazu zählen folgende Elemente:

  • Dokumente und Arbeitsblätter in Anpassungen auf Dokumentebene

  • Aktionsbereiche in Anpassungen auf Dokumentebene

  • Benutzerdefinierte Aufgabenbereiche in Add-Ins auf Anwendungsebene

  • Formularbereiche in Add-Ins auf Anwendungsebene für Outlook

Link zu Video Eine Videodemonstration zu diesem Thema finden Sie unter How Do I: Use WPF Controls Inside an Excel Actions Pane?.

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 dem Projekt stattdessen ein Benutzersteuerelement (WPF) 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 dem Projekt ein Benutzersteuerelement (WPF) hinzu.

  3. Fügen Sie aus der Toolbox der Entwurfsoberfläche für WPF-Benutzersteuerelemente WPF-Steuerelemente hinzu.

    Wenn der WPF-Benutzersteuerelement-Designer geöffnet wird, 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 von 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 dem Projekt ein Benutzersteuerelement (WPF) hinzu.

  3. Fügen Sie aus der Toolbox der Entwurfsoberfläche für WPF-Benutzersteuerelemente WPF-Steuerelemente hinzu.

  4. Erstellen Sie das Projekt.

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

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

  7. Ziehen Sie von der Registerkarte ProjectName WPF-Benutzersteuerelemente 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.

    Tipp

    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. Zur Entwurfszeit können Sie z. B. Dokumenten und Arbeitsblättern Windows Forms-Steuerelemente hinzufügen, indem Sie Steuerelemente aus der Toolbox ziehen. Zur Laufzeit können Sie dazu Hilfsmethoden verwenden. 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. Eine exemplarische Vorgehensweise, die veranschaulicht, wie die ElementHost-Klasse programmgesteuert verwendet wird, finden Sie unter Gewusst wie: Hosten eines WPF-Steuerelements in Windows Forms mit ElementHost.

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:

Siehe auch

Aufgaben

Gewusst wie: Hinzufügen eines Aktionsbereichs zu Word-Dokumenten

Gewusst wie: Hinzufügen eines Aktionsbereichs zu Excel-Arbeitsmappen

Gewusst wie: Hinzufügen eines benutzerdefinierten Aufgabenbereichs zu einer Anwendung

Gewusst wie: Hinzufügen eines Bereichs zu einem Outlook-Add-In-Projekt

Konzepte

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

Weitere Ressourcen

Anpassung der Office-Benutzeroberfläche

Aktionsbereichsübersicht

Übersicht über benutzerdefinierte Aufgabenbereiche

Erstellen von Outlook-Formularbereichen