Compartir a través de

Guía paso a paso: Asignación de propiedades mediante el control ElementHost

En este tutorial se muestra cómo usar la PropertyMap propiedad para asignar propiedades de Windows Forms a las propiedades correspondientes en un elemento WPF hospedado.

Las tareas que se muestran en este tutorial incluyen:

  • Creación del proyecto.

  • Definir un nuevo mapeo de propiedades.

  • Eliminar una asignación predeterminada de propiedades.

  • Extensión de una asignación de propiedades predeterminada.

Cuando haya terminado, podrá asignar propiedades de Windows Forms a las propiedades de WPF correspondientes en un elemento hospedado.

Prerrequisitos

Necesitará los componentes siguientes para completar este tutorial:

  • Visual Studio 2017

Creación del proyecto

Para crear el proyecto

  1. Cree un proyecto de aplicación de Windows Forms denominado PropertyMappingWithElementHost.

  2. En Explorador de Soluciones, agregue referencias a los siguientes ensamblados de WPF.

    • PresentationCore

    • PresentationFramework

    • WindowsBase

    • WindowsFormsIntegration

  3. Copie el código siguiente en la parte superior del Form1 archivo de código.

    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

  4. Abra Form1 en el Diseñador de Windows Forms. Haga doble clic en el formulario para agregar un controlador de eventos para el Load evento.

  5. Vuelva al Diseñador de Windows Forms y agregue un controlador de eventos para el evento del Resize formulario. Para obtener más información, vea Cómo: Crear controladores de eventos utilizando el diseñador.

  6. Declare un ElementHost campo en la Form1 clase .

    ElementHost elemHost = null;

    Private elemHost As ElementHost = Nothing

Definiendo nuevas asignaciones de propiedades

El ElementHost control proporciona varias asignaciones de propiedades predeterminadas. Agregue una nueva asignación de propiedades llamando al método Add en el ElementHost del control PropertyMap.

Para definir nuevas asignaciones de propiedades

  1. Copie el código siguiente en la definición de la Form1 clase .

    // 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

    El AddMarginMapping método agrega una nueva asignación para la Margin propiedad .

    El OnMarginChange método traduce la Margin propiedad a la propiedad WPF Margin .

  2. Copie el código siguiente en la definición de la Form1 clase .

    // 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

    El AddRegionMapping método agrega una nueva asignación para la Region propiedad .

    El OnRegionChange método traduce la Region propiedad a la propiedad WPF Clip .

    El Form1_Resize método controla el evento del Resize formulario y ajusta el tamaño de la región de recorte para ajustarse al elemento hospedado.

Eliminar una asignación de propiedades predeterminada

Elimine una asignación de propiedades predeterminada llamando al método Remove en el ElementHost del control PropertyMap.

Para quitar una asignación de propiedades predeterminada

  • Copie el código siguiente en la definición de la Form1 clase .

    // 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

    El RemoveCursorMapping método elimina la asignación predeterminada de la propiedad Cursor.

Extender un mapeo de propiedad predeterminada

Puede usar una asignación de propiedades predeterminada y también ampliarla con su propia asignación.

Para ampliar una asignación de propiedades predeterminada

  • Copie el código siguiente en la definición de la Form1 clase .

    // 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

    El método ExtendBackColorMapping agrega un traductor de propiedades personalizado a la BackColor asignación de propiedades existente.

    El OnBackColorChange método asigna una imagen específica a la propiedad del Background control hospedado. Se llama al método OnBackColorChange después de que se haya aplicado la asignación de propiedades predeterminada.

Inicializa tus asignaciones de propiedades

  1. Copie el código siguiente en la definición de la Form1 clase .

    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

    El Form1_Load método controla el Load evento y realiza la siguiente inicialización.

    • Crea un elemento WPF Button .

    • Llama a los métodos que definió anteriormente en el tutorial para configurar las asignaciones de propiedades.

    • Asigna valores iniciales a las propiedades mapeadas.

  2. Presione F5 para compilar y ejecutar la aplicación.

Consulte también