Freigeben über

Exemplarische Vorgehensweise: Erstellen neuer WPF-Inhalte in Windows Forms zur Entwurfszeit

  • Artikel

In diesem Artikel erfahren Sie, wie Sie ein Windows Presentation Foundation (WPF)-Steuerelement für die Verwendung in Ihren Windows Forms-basierten Anwendungen erstellen.

Voraussetzungen

Sie benötigen Visual Studio, um diese Anleitung abzuschließen.

Projekt erstellen

Öffnen Sie Visual Studio, und erstellen Sie ein neues Windows Forms App (.NET Framework) Projekt in Visual Basic oder Visual C# mit dem Namen HostingWpf.

Anmerkung

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

Erstellen eines neuen WPF-Steuerelements

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

Anmerkung

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:

  1. Fügen Sie im Projektmappen-Explorer ein neues Projekt WPF-Benutzersteuerelementbibliothek (.NET Framework) zur Projektmappe hinzu. Verwenden Sie den Standardnamen für die Steuerelementbibliothek, WpfControlLibrary1. Der Standardname für das Steuerelement lautet UserControl1.xaml.

    Das Hinzufügen des neuen Steuerelements hat die folgenden Auswirkungen:

    • Datei UserControl1.xaml wird hinzugefügt.

    • Datei-UserControl1.xaml.cs (oder UserControl1.xaml.vb) wird 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 im WPF-Designer für Visual Studio geöffnet.

  2. Stellen Sie in der Entwurfsansicht sicher, dass UserControl1 ausgewählt ist.

  3. Legen Sie im Fenster Eigenschaften den Wert der eigenschaften Width und Height auf 200fest.

  4. Ziehen Sie ein System.Windows.Controls.TextBox-Steuerelement aus der Toolbox auf die Designoberfläche.

  5. Legen Sie im Fenster Eigenschaften den Wert der Text-Eigenschaft auf Gehosteter Inhalt fest.

    Anmerkung

    Im Allgemeinen sollten Sie anspruchsvollere WPF-Inhalte hosten. System.Windows.Controls.TextBox-Steuerelement wird hier nur zur Veranschaulichung verwendet.

  6. Projekt erstellen.

Hinzufügen eines WPF-Steuerelements zu einem Windows-Formular

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

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

  1. Öffnen Sie Form1 im Windows Forms-Designer.

  2. Suchen Sie in der Toolbox die Registerkarte mit der Bezeichnung WPFUserControlLibrary WPF-Benutzersteuerelemente.

  3. 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 Fenster Eigenschaften wird seine Child-Eigenschaft als auf UserControl1 festgelegt angezeigt.

    • 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.

  4. Wählen Sie im Smarttagbereich ElementHost-Aufgaben die Option In übergeordnetem Container andocken aus.

  5. Drücken Sie F5-, um die Anwendung zu erstellen und auszuführen.

Nächste Schritte

Windows Forms und WPF sind unterschiedliche Technologien, aber sie sind darauf ausgelegt, eng miteinander zu arbeiten. Um die Darstellung und das Verhalten in Ihren Anwendungen zu optimieren, versuchen Sie Folgendes:

Weitere Informationen