Exemplarische Vorgehensweise: Erstellen neuen Windows Presentation Foundation-Inhalts in Windows Forms zur Entwurfszeit

Artikel
08/20/2008

Aktualisiert: November 2007

In diesem Thema wird veranschaulicht, wie Sie ein Windows Presentation Foundation-Steuerelement (WPF) zur Verwendung in Windows Forms-basierten Anwendungen erstellen.

Im Verlauf dieser exemplarischen Vorgehensweise führen Sie folgende Aufgaben aus:

Erstellen des Projekts
Erstellen eines neuen WPF-Steuerelements
Hinzufügen des neuen WPF-Steuerelements zu einem Windows Form. Das WPF-Steuerelement wird in einem ElementHost-Steuerelement gehostet.

Hinweis:
Je nach den aktivierten Einstellungen oder der verwendeten Version können sich die angezeigten Dialogfelder und Menübefehle von den in der Hilfe beschriebenen unterscheiden. Klicken Sie zum Ändern der Einstellungen im Menü Extras auf Einstellungen importieren und exportieren. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

Vorbereitungsmaßnahmen

Zum Durchführen dieser exemplarischen Vorgehensweise benötigen Sie die folgenden Komponenten:

Visual Studio 2008.

Erstellen des Projekts

Zunächst muss das Windows Forms-Projekt erstellt werden.

Hinweis:
Beim Hosten von WPF-Inhalt werden nur C#- und Visual Basic-Projekte unterstützt.

So erstellen Sie das Projekt

Erstellen Sie in Visual Basic oder Visual C# ein neues Windows Forms-Anwendungsprojekt mit dem Namen HostingWpf. Weitere Informationen finden Sie unter Gewusst wie: Erstellen eines Windows-Anwendungsprojekts.

Erstellen eines neuen WPF-Steuerelements

Das Erstellen eines neuen WPF-Steuerelements und das Hinzufügen des Steuerelements zum Projekt ist genauso einfach wie das Hinzufügen eines beliebigen anderen Elements zum Projekt. Der Windows Forms-Designer wird zusammen mit einem bestimmten Steuerelementtyp mit dem Namen zusammengesetztes Steuerelement oder Benutzersteuerelement verwendet. Weitere Informationen über WPF-Benutzersteuerelemente finden Sie unter UserControl.

Hinweis:
Der System.Windows.Controls.UserControl-Typ für WPF unterscheidet sich vom Windows Forms-Benutzersteuerelementtyp, der ebenfalls den Namen System.Windows.Forms.UserControl hat.

So erstellen Sie ein neues WPF-Steuerelement

Fügen Sie dem Projekt im Projektmappen-Explorer ein neues Benutzersteuerelement (WPF)-Element hinzu. Verwenden Sie den Standardnamen UserControl1 für den Steuerelementtyp. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen und Entfernen von Projektmappenelementen. Verwenden Sie den Standardnamen UserControl1.xaml.

Das Hinzufügen des neuen Steuerelements hat folgende Auswirkungen:
- Die Datei UserControl1.xaml wird dem Projekt hinzugefügt.
- Entweder die Datei UserControl1.xaml.cs oder die Datei UserControl1.xaml.vb wird dem Projekt hinzugefügt. Diese Datei enthält das Code-Behind-Modell für Ereignishandler und andere Implementierungen.
- Verweise auf WPF-Assemblys werden dem Projekt hinzugefügt.
- Die Datei UserControl1.xaml wird in Windows Presentation Foundation (WPF)-Designer für Visual Studio geöffnet.
Stellen Sie in der Entwurfsansicht sicher, dass UserControl1 ausgewählt ist. Weitere Informationen finden Sie unter Gewusst wie: Auswählen und Verschieben von Elementen auf der Entwurfsoberfläche.
Legen Sie im Eigenschaftenfenster den Wert der Width-Eigenschaft und der Height-Eigenschaft auf 200 fest.
Ziehen Sie ein System.Windows.Controls.TextBox-Steuerelement aus der Toolbox auf die Entwurfsoberfläche.
Legen Sie im Eigenschaftenfenster den Wert der Text-Eigenschaft auf Hosted Content fest.

Hinweis:

Normalerweise sollten Sie anspruchsvolleren WPF-Inhalt hosten. Das System.Windows.Controls.TextBox-Steuerelement wird nur zur Veranschaulichung verwendet.
Erstellen Sie das Projekt.

Hinweis:
Normalerweise sollten Sie anspruchsvolleren WPF-Inhalt hosten. Das System.Windows.Controls.TextBox-Steuerelement wird nur zur Veranschaulichung verwendet.

Hinzufügen eines WPF-Steuerelements zu einem Windows Form

Das neue WPF-Steuerelement kann jetzt im Formular verwendet werden. Windows Forms verwendet das ElementHost-Steuerelement zum Hosten des WPF-Inhalts.

So fügen Sie einem Windows Form ein WPF-Steuerelement hinzu

Öffnen Sie Form1 im Windows Forms-Designer.
Suchen Sie in der Toolbox die Registerkarte mit der Bezeichnung HostingWpf WPF-Benutzersteuerelemente.
Ziehen Sie eine Instanz von UserControl1 auf das Formular.
- Ein ElementHost-Steuerelement wird automatisch zum Hosten des WPF-Steuerelements auf dem Formular erstellt.
- Das ElementHost-Steuerelement hat den Namen elementHost1, und im Eigenschaftenfenster wird die Child-Eigenschaft auf UserControl1 festgelegt.
- Verweise auf WPF-Assemblys werden dem Projekt hinzugefügt.
- Das elementHost1-Steuerelement verfügt über einen Smarttagbereich, in dem die verfügbaren Hostingoptionen anzeigt werden.
Wählen Sie im Smarttagbereich ElementHost-Aufgaben die Option In übergeordnetem Container andocken aus.
Drücken Sie F5, um die Anwendung zu erstellen und auszuführen.

Nächste Schritte

Windows Forms und WPF sind unterschiedliche Technologien, die jedoch für die enge Zusammenarbeit konzipiert wurden. Um die Darstellung und das Verhalten in Ihren Anwendungen zu optimieren, versuchen Sie Folgendes: