Panduan: Memetakan Properti Menggunakan Kontrol ElementHost

Panduan ini menunjukkan kepada Anda cara menggunakan properti PropertyMap untuk memetakan properti Formulir Windows ke properti terkait pada elemen WPF yang dihosting.

Tugas yang diilustrasikan dalam panduan ini meliputi:

Membuat proyek.
Menentukan pemetaan properti baru.
Menghapus pemetaan properti default.
Memperpanjang pemetaan properti bawaan.

Setelah selesai, Anda akan dapat memetakan properti Formulir Windows ke properti WPF yang sesuai pada elemen yang dihosting.

Prasyarat

Anda memerlukan komponen berikut untuk menyelesaikan panduan ini:

Visual Studio 2017

Membuat Proyek

Untuk membuat proyek

Buat proyek Aplikasi Formulir Windows bernama .
Di Solution Explorer, tambahkan referensi ke rakitan WPF berikut.
- PresentationCore
- PresentationFramework
- WindowsBase
- WindowsFormsIntegration

Salin kode berikut ke bagian atas file kode Form1.

using System.Windows;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Forms.Integration;

Imports System.Windows
Imports System.Windows.Media
Imports System.Windows.Media.Imaging
Imports System.Windows.Forms.Integration

Buka Form1 di Windows Forms Designer. Klik dua kali formulir untuk menambahkan penanganan aktivitas untuk peristiwa Load.
Kembali ke Windows Forms Designer dan tambahkan penangan peristiwa untuk event Resize pada formulir tersebut. Untuk informasi selengkapnya, lihat Cara: Membuat Penanganan Acara dengan Menggunakan Perancang.

Deklarasikan bidang ElementHost di kelas Form1.

ElementHost elemHost = null;

Private elemHost As ElementHost = Nothing

Menentukan Pemetaan Properti Baru

Kontrol ElementHost menyediakan beberapa pemetaan properti default. Anda menambahkan pemetaan properti baru dengan memanggil metode Add pada ElementHostdari kontrol PropertyMap.

Untuk menentukan pemetaan properti baru

Salin kode berikut ke dalam definisi untuk kelas Form1.

// The AddMarginMapping method adds a new property mapping
// for the Margin property.
private void AddMarginMapping()
{
    elemHost.PropertyMap.Add(
        "Margin",
        new PropertyTranslator(OnMarginChange));
}

// The OnMarginChange method implements the mapping
// from the Windows Forms Margin property to the
// Windows Presentation Foundation Margin property.
//
// The provided Padding value is used to construct
// a Thickness value for the hosted element's Margin
// property.
private void OnMarginChange(object h, String propertyName, object value)
{
    ElementHost host = h as ElementHost;
    Padding p = (Padding)value;
    System.Windows.Controls.Button wpfButton =
        host.Child as System.Windows.Controls.Button;

    Thickness t = new Thickness(p.Left, p.Top, p.Right, p.Bottom );

    wpfButton.Margin = t;
}

' The AddMarginMapping method adds a new property mapping
' for the Margin property.
Private Sub AddMarginMapping()

    elemHost.PropertyMap.Add( _
        "Margin", _
        New PropertyTranslator(AddressOf OnMarginChange))

End Sub


' The OnMarginChange method implements the mapping 
' from the Windows Forms Margin property to the
' Windows Presentation Foundation Margin property.
'
' The provided Padding value is used to construct 
' a Thickness value for the hosted element's Margin
' property.
Private Sub OnMarginChange( _
ByVal h As Object, _
ByVal propertyName As String, _
ByVal value As Object)

    Dim host As ElementHost = h
    Dim p As Padding = CType(value, Padding)
    Dim wpfButton As System.Windows.Controls.Button = host.Child


    Dim t As New Thickness(p.Left, p.Top, p.Right, p.Bottom)

    wpfButton.Margin = t

End Sub

Metode AddMarginMapping menambahkan pemetaan baru untuk properti Margin.

Metode OnMarginChange menerjemahkan properti Margin ke properti Margin WPF.

Salin kode berikut ke dalam definisi untuk kelas Form1.

// The AddRegionMapping method assigns a custom
// mapping for the Region property.
private void AddRegionMapping()
{
    elemHost.PropertyMap.Add(
        "Region",
        new PropertyTranslator(OnRegionChange));
}

// The OnRegionChange method assigns an EllipseGeometry to
// the hosted element's Clip property.
private void OnRegionChange(
    object h,
    String propertyName,
    object value)
{
    ElementHost host = h as ElementHost;
    System.Windows.Controls.Button wpfButton =
        host.Child as System.Windows.Controls.Button;

    wpfButton.Clip = new EllipseGeometry(new Rect(
        0,
        0,
        wpfButton.ActualWidth,
        wpfButton.ActualHeight));
}

// The Form1_Resize method handles the form's Resize event.
// It calls the OnRegionChange method explicitly to
// assign a new clipping geometry to the hosted element.
private void Form1_Resize(object sender, EventArgs e)
{
    this.OnRegionChange(elemHost, "Region", null);
}

' The AddRegionMapping method assigns a custom 
' mapping for the Region property.
Private Sub AddRegionMapping()

    elemHost.PropertyMap.Add( _
        "Region", _
        New PropertyTranslator(AddressOf OnRegionChange))

End Sub


' The OnRegionChange method assigns an EllipseGeometry to
' the hosted element's Clip property.
Private Sub OnRegionChange( _
ByVal h As Object, _
ByVal propertyName As String, _
ByVal value As Object)

    Dim host As ElementHost = h

    Dim wpfButton As System.Windows.Controls.Button = host.Child

    wpfButton.Clip = New EllipseGeometry(New Rect( _
        0, _
        0, _
        wpfButton.ActualWidth, _
        wpfButton.ActualHeight))

End Sub


' The Form1_Resize method handles the form's Resize event.
' It calls the OnRegionChange method explicitly to 
' assign a new clipping geometry to the hosted element.
Private Sub Form1_Resize( _
ByVal sender As Object, _
ByVal e As EventArgs) Handles MyBase.Resize

    If elemHost IsNot Nothing Then
        Me.OnRegionChange(elemHost, "Region", Nothing)
    End If

End Sub

Metode AddRegionMapping menambahkan pemetaan baru untuk properti Region.

Metode OnRegionChange menerjemahkan properti Region ke properti Clip WPF.

Metode Form1_Resize menangani peristiwa formulir Resize dan mengatur ukuran area kliping agar sesuai dengan elemen yang dihost.

Menghapus Pemetaan Properti Default

Hapus pemetaan properti default dengan memanggil metode Remove pada kontrol ElementHost di PropertyMap.

Untuk menghapus pemetaan properti default

Salin kode berikut ke dalam definisi untuk kelas Form1.

// The RemoveCursorMapping method deletes the default
// mapping for the Cursor property.
private void RemoveCursorMapping()
{
    elemHost.PropertyMap.Remove("Cursor");
}

' The RemoveCursorMapping method deletes the default
' mapping for the Cursor property.
Private Sub RemoveCursorMapping()
    elemHost.PropertyMap.Remove("Cursor")
End Sub

Metode RemoveCursorMapping menghapus pemetaan default untuk properti Cursor.

Memperluas Pemetaan Properti Default

Anda dapat menggunakan pemetaan properti default dan juga memperluasnya dengan pemetaan Anda sendiri.

Untuk memperluas pemetaan properti bawaan

Salin kode berikut ke dalam definisi untuk kelas Form1.

// The ExtendBackColorMapping method adds a property
// translator if a mapping already exists.
private void ExtendBackColorMapping()
{
    if (elemHost.PropertyMap["BackColor"] != null)
    {
        elemHost.PropertyMap["BackColor"] +=
            new PropertyTranslator(OnBackColorChange);
    }
}

// The OnBackColorChange method assigns a specific image
// to the hosted element's Background property.
private void OnBackColorChange(object h, String propertyName, object value)
{
    ElementHost host = h as ElementHost;
    System.Windows.Controls.Button wpfButton =
        host.Child as System.Windows.Controls.Button;

    ImageBrush b = new ImageBrush(new BitmapImage(
        new Uri(@"file:///C:\WINDOWS\Santa Fe Stucco.bmp")));
    wpfButton.Background = b;
}

' The ExtendBackColorMapping method adds a property
' translator if a mapping already exists.
Private Sub ExtendBackColorMapping()

    If elemHost.PropertyMap("BackColor") IsNot Nothing Then

        elemHost.PropertyMap("BackColor") = PropertyTranslator.Combine( _
            elemHost.PropertyMap("BackColor"), _
            PropertyTranslator.CreateDelegate( _
            GetType(PropertyTranslator), _
            Me, _
            "OnBackColorChange"))
    End If

End Sub


' The OnBackColorChange method assigns a specific image 
' to the hosted element's Background property.
Private Sub OnBackColorChange( _
ByVal h As Object, _
ByVal propertyName As String, _
ByVal value As Object)

    Dim host As ElementHost = h
    Dim wpfButton As System.Windows.Controls.Button = host.Child
    Dim b As New ImageBrush(New BitmapImage( _
        New Uri("file:///C:\WINDOWS\Santa Fe Stucco.bmp")))
    wpfButton.Background = b

End Sub

Metode ExtendBackColorMapping menambahkan penerjemah properti kustom ke pemetaan properti BackColor yang ada.

Metode OnBackColorChange menetapkan gambar tertentu ke properti Background kontrol yang dihosting. Metode OnBackColorChange dipanggil setelah pemetaan properti default diterapkan.

Menginisialisasi pemetaan properti Anda

Salin kode berikut ke dalam definisi untuk kelas Form1.

private void Form1_Load(object sender, EventArgs e)
{
    // Create the ElementHost control.
    elemHost = new ElementHost();
    elemHost.Dock = DockStyle.Fill;
    this.Controls.Add(elemHost);

    // Create a Windows Presentation Foundation Button element
    // and assign it as the ElementHost control's child.
    System.Windows.Controls.Button wpfButton = new System.Windows.Controls.Button();
    wpfButton.Content = "Windows Presentation Foundation Button";
    elemHost.Child = wpfButton;

    // Map the Margin property.
    this.AddMarginMapping();

    // Remove the mapping for the Cursor property.
    this.RemoveCursorMapping();

    // Add a mapping for the Region property.
    this.AddRegionMapping();

    // Add another mapping for the BackColor property.
    this.ExtendBackColorMapping();

    // Cause the OnMarginChange delegate to be called.
    elemHost.Margin = new Padding(23, 23, 23, 23);

    // Cause the OnRegionChange delegate to be called.
    elemHost.Region = new Region();

    // Cause the OnBackColorChange delegate to be called.
    elemHost.BackColor = System.Drawing.Color.AliceBlue;
}

Private Sub Form1_Load( _
ByVal sender As Object, _
ByVal e As EventArgs) Handles MyBase.Load

    ' Create the ElementHost control.
    elemHost = New ElementHost()
    elemHost.Dock = DockStyle.Fill
    Me.Controls.Add(elemHost)

    ' Create a Windows Presentation Foundation Button element 
    ' and assign it as the ElementHost control's child. 
    Dim wpfButton As New System.Windows.Controls.Button()
    wpfButton.Content = "Windows Presentation Foundation Button"
    elemHost.Child = wpfButton

    ' Map the Margin property.
    Me.AddMarginMapping()

    ' Remove the mapping for the Cursor property.
    Me.RemoveCursorMapping()

    ' Add a mapping for the Region property.
    Me.AddRegionMapping()

    ' Add another mapping for the BackColor property.
    Me.ExtendBackColorMapping()

    ' Cause the OnMarginChange delegate to be called.
    elemHost.Margin = New Padding(23, 23, 23, 23)

    ' Cause the OnRegionChange delegate to be called.
    elemHost.Region = New [Region]()

    ' Cause the OnBackColorChange delegate to be called.
    elemHost.BackColor = System.Drawing.Color.AliceBlue

End Sub

Metode Form1_Load menangani peristiwa Load dan melakukan inisialisasi berikut.

Membuat elemen Button WPF.
Memanggil metode yang sudah Anda tentukan sebelumnya dalam panduan ini untuk menyiapkan pemetaan properti.
Menetapkan nilai awal ke properti yang dipetakan.

Tekan F5 untuk membangun dan menjalankan aplikasi.

Lihat juga

ElementHost.PropertyMap
WindowsFormsHost.PropertyMap
WindowsFormsHost
Pemetaan Properti Formulir Windows dan WPF
Mendesain XAML di Visual Studio
Panduan Langkah-demi-Langkah: Menghosting Kontrol Komposit WPF di Windows Forms

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-05-07

Bagikan melalui

Panduan: Memetakan Properti Menggunakan Kontrol ElementHost

Prasyarat

Membuat Proyek

Untuk membuat proyek

Menentukan Pemetaan Properti Baru

Untuk menentukan pemetaan properti baru

Menghapus Pemetaan Properti Default

Untuk menghapus pemetaan properti default

Memperluas Pemetaan Properti Default

Untuk memperluas pemetaan properti bawaan

Menginisialisasi pemetaan properti Anda

Lihat juga

Saran dan Komentar

Sumber Daya Tambahan: