Verwenden von WPF-Steuerelementen in Office-Projektmappen

Artikel
04/28/2010

Aktualisiert: November 2007

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 Windows Presentation Foundation.

Obwohl Visual Studio Tools for Office-Projektmappen so entworfen wurden, dass sie mit Windows Forms-Steuerelementen funktionieren, können Sie in den Projektmappen auch WPF-Steuerelemente verwenden. Jedes Benutzeroberflächenelement, das Windows Forms-Steuerelemente in einer Visual Studio Tools for 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

Hinzufügen von WPF-Steuerelementen zu Visual Studio Tools for Office-Projekten zur Entwurfszeit

Sie können Benutzeroberflächenelementen in Visual Studio Tools for 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

Öffnen Sie ein Projekt, dem Sie einen benutzerdefinierten Aufgabenbereich, einen Aktionsbereich oder einen Formularbereich hinzufügen möchten.
Fügen Sie dem Projekt ein Benutzersteuerelement (WPF) hinzu.
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.
Erstellen Sie das Projekt.
Fügen Sie dem Projekt einen Aktionsbereich, einen Formularbereich oder einen benutzerdefinierten Aufgabenbereich hinzu:
- Fügen Sie für Formularbereiche dem Projekt ein Element für den Outlook-Formularbereich hinzu. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines Bereichs zu einem Outlook-Add-In-Projekt.
- Fügen Sie dem Projekt für Aktionsbereiche ein Aktionsbereich-Steuerelement oder ein Benutzersteuerelement hinzu. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines Aktionsbereichs zu Word-Dokumenten und unter Gewusst wie: Hinzufügen eines Aktionsbereichs zu Excel-Arbeitsmappen.
- Fügen Sie dem Projekt für benutzerdefinierte Aufgabenbereiche ein Benutzersteuerelement hinzu. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines benutzerdefinierten Aufgabenbereichs zu einer Anwendung.
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.
Erstellen Sie das Projekt neu.

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

Öffnen Sie ein Projekt auf Dokumentebene für Word oder Excel.
Fügen Sie dem Projekt ein Benutzersteuerelement (WPF) hinzu.
Fügen Sie aus der Toolbox der Entwurfsoberfläche für WPF-Benutzersteuerelemente WPF-Steuerelemente hinzu.
Erstellen Sie das Projekt.
Fügen Sie dem Projekt ein Benutzersteuerelement (d. h. ein Windows Forms-Benutzersteuerelement) hinzu.
Öffnen Sie den Designer für das Windows Forms-Benutzersteuerelement.
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.
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.
Erstellen Sie das Projekt neu.

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

Hosten von WPF-Steuerelementen mithilfe der ElementHost-Klasse

Visual Studio Tools for Office bietet Features, die Sie beim Verwenden von Windows Forms-Steuerelementen in der Projektmappe unterstützen, aber es fehlen vergleichbare Features 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. Die ElementHost-Klasse wird von .NET Framework ab Version 3.0 bereitgestellt.

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 Windows Presentation Foundation-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: