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

Artikel
08/10/2011

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.

Tipp

Je nach den aktiven Einstellungen oder der Version unterscheiden sich die Dialogfelder und Menübefehle auf Ihrem Bildschirm möglicherweise von den in der Hilfe beschriebenen. Klicken Sie im Menü Extras auf Einstellungen importieren und exportieren, um die Einstellungen zu ändern. Weitere Informationen finden Sie unter Arbeiten mit 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.

Tipp

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 neuen Windows Forms-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.

Tipp

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 im Projektmappen-Explorer ein neues Projekt WPF-Benutzersteuerelementbibliothek zur Projektmappe hinzu. Verwenden Sie den Standardnamen WpfControlLibrary1 für die Steuerelementbibliothek. Der Standardname für das Steuerelement ist UserControl1.xaml.

Das Hinzufügen des neuen Steuerelements hat folgende Auswirkungen:
- Die Datei UserControl1.xaml wird hinzugefügt.
- Es wird entweder die Datei UserControl1.xaml.cs oder die Datei UserControl1.xaml.vb hinzugefügt. Diese Datei enthält das Code-Behind-Modell für Ereignishandler und andere Implementierungen.
- Es werden Verweise auf die WPF-Assemblys hinzugefügt.
- Die Datei UserControl1.xaml wird in 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.

Tipp

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

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 WPFUserControlLibrary 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: