Delen via

Stapsgewijze handleiding: Eigenschappen toewijzen met behulp van het WindowsFormsHost-element

In dit overzicht ziet u hoe u de PropertyMap eigenschap kunt gebruiken om WPF-eigenschappen toe te wijzen aan de bijbehorende eigenschappen op een gehost Windows Forms-besturingselement.

De taken die in deze handleiding worden geïllustreerd, zijn onder andere:

  • Het project aanmaken.

  • De indeling van de toepassing definiëren.

  • Een nieuwe eigenschapstoewijzing definiëren.

  • Een standaardeigenschapstoewijzing verwijderen.

  • Een standaardtoewijzing van eigenschappen vervangen.

  • Een standaard eigenschap-mapping uitbreiden.

Wanneer u klaar bent, kunt u WPF-eigenschappen toewijzen aan de bijbehorende eigenschappen op een gehost Windows Forms-besturingselement.

Vereiste voorwaarden

U hebt de volgende onderdelen nodig om dit scenario te voltooien:

  • Visual Studio 2017

Het project maken en instellen

  1. Maak een WPF App project met de naam PropertyMappingWithWfhSample.

  2. Voeg in Solution Explorereen verwijzing toe naar de WindowsFormsIntegration-assembly met de naam WindowsFormsIntegration.dll.

  3. Voeg in Solution Explorer verwijzingen toe naar de assembly's System.Drawing en System.Windows.Forms.

De indeling van de toepassing definiëren

De WPF-toepassing gebruikt het WindowsFormsHost element om een Windows Forms-besturingselement te hosten.

De indeling van de toepassing definiëren

  1. Open Window1.xaml in de WPF Designer.

  2. Vervang de bestaande code door de volgende code.

    <Window x:Class="PropertyMappingWithWfh.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    Title="PropertyMappingWithWfh" Height="300" Width="300"
    Loaded="WindowLoaded">
  <DockPanel Name="panel1" LastChildFill="True">
    <WindowsFormsHost Name="wfHost" DockPanel.Dock="Left" SizeChanged="Window1_SizeChanged" FontSize="20" />
  </DockPanel>
</Window>

  3. Open Window1.xaml.cs in de Code-editor.

  4. Importeer bovenaan het bestand de volgende naamruimten.

    using System.Drawing;
using System.Drawing.Drawing2D;
using System.Windows.Forms;
using System.Windows.Forms.Integration;

    Imports System.Drawing
Imports System.Drawing.Drawing2D
Imports System.Windows.Forms
Imports System.Windows.Forms.Integration

Een nieuwe eigenschapstoewijzing definiëren

Het WindowsFormsHost element biedt verschillende standaardeigenschapstoewijzingen. U voegt een nieuwe eigenschapstoewijzing toe door de Add methode aan te roepen op het WindowsFormsHost element's PropertyMap.

Een nieuwe eigenschapstoewijzing definiëren

  • Kopieer de volgende code naar de definitie voor de Window1 klasse.

    // The AddClipMapping method adds a custom
// mapping for the Clip property.
private void AddClipMapping()
{
    wfHost.PropertyMap.Add(
        "Clip",
        new PropertyTranslator(OnClipChange));
}

// The OnClipChange method assigns an elliptical clipping
// region to the hosted control's Region property.
private void OnClipChange(object h, String propertyName, object value)
{
    WindowsFormsHost host = h as WindowsFormsHost;
    System.Windows.Forms.CheckBox cb = host.Child as System.Windows.Forms.CheckBox;

    if (cb != null)
    {
        cb.Region = this.CreateClipRegion();
    }
}

// The Window1_SizeChanged method handles the window's
// SizeChanged event. It calls the OnClipChange method explicitly
// to assign a new clipping region to the hosted control.
private void Window1_SizeChanged(object sender, SizeChangedEventArgs e)
{
    this.OnClipChange(wfHost, "Clip", null);
}

// The CreateClipRegion method creates a Region from an
// elliptical GraphicsPath.
private Region CreateClipRegion()
{
    GraphicsPath path = new GraphicsPath();

    path.StartFigure();

    path.AddEllipse(new System.Drawing.Rectangle(
        0,
        0,
        (int)wfHost.ActualWidth,
        (int)wfHost.ActualHeight ) );

    path.CloseFigure();

    return( new Region(path) );
}

    ' The AddClipMapping method adds a custom mapping 
' for the Clip property.
Private Sub AddClipMapping()

    wfHost.PropertyMap.Add( _
        "Clip", _
        New PropertyTranslator(AddressOf OnClipChange))

End Sub

' The OnClipChange method assigns an elliptical clipping 
' region to the hosted control's Region property.
Private Sub OnClipChange( _
ByVal h As Object, _
ByVal propertyName As String, _
ByVal value As Object)

    Dim host As WindowsFormsHost = h

    Dim cb As System.Windows.Forms.CheckBox = host.Child

    If cb IsNot Nothing Then
        cb.Region = Me.CreateClipRegion()
    End If

End Sub

' The Window1_SizeChanged method handles the window's 
' SizeChanged event. It calls the OnClipChange method explicitly 
' to assign a new clipping region to the hosted control.
Private Sub Window1_SizeChanged( _
ByVal sender As Object, _
ByVal e As SizeChangedEventArgs)

    Me.OnClipChange(wfHost, "Clip", Nothing)

End Sub

' The CreateClipRegion method creates a Region from an
' elliptical GraphicsPath.
Private Function CreateClipRegion() As [Region] 
    Dim path As New GraphicsPath()
    
    path.StartFigure()
    
    path.AddEllipse(New System.Drawing.Rectangle( _
        0, _
        0, _
        wfHost.ActualWidth, _
        wfHost.ActualHeight))
    
    path.CloseFigure()
    
    Return New [Region](path)

End Function

    De AddClipMapping-methode voegt een nieuwe toewijzing toe voor de Clip-eigenschap.

    De OnClipChange methode vertaalt de Clip eigenschap naar de eigenschap Windows FormsRegion .

    De methode Window1_SizeChanged verwerkt het SizeChanged evenement van het venster en past de grootte van het knipgebied aan om het toepassingsvenster te passen.

Het verwijderen van een standaard eigenschapstoewijzing

Verwijder een standaardeigenschapstoewijzing door de Remove-methode aan te roepen op het WindowsFormsHost-element's PropertyMap.

Een standaardeigenschapstoewijzing verwijderen

  • Kopieer de volgende code naar de definitie voor de Window1 klasse.

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

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

    De RemoveCursorMapping methode verwijdert de standaardtoewijzing voor de Cursor eigenschap.

Het vervangen van een standaardeigenschapstoewijzing

Vervang een standaardtoewijzing van een eigenschap door de standaardtoewijzing te verwijderen en de Add methode aan te roepen op de WindowsFormsHost van het PropertyMap-element.

Een standaard eigenschapstoewijzing vervangen

  • Kopieer de volgende code naar de definitie voor de Window1 klasse.

    // The ReplaceFlowDirectionMapping method replaces the
// default mapping for the FlowDirection property.
private void ReplaceFlowDirectionMapping()
{
    wfHost.PropertyMap.Remove("FlowDirection");

    wfHost.PropertyMap.Add(
        "FlowDirection",
        new PropertyTranslator(OnFlowDirectionChange));
}

// The OnFlowDirectionChange method translates a
// Windows Presentation Foundation FlowDirection value
// to a Windows Forms RightToLeft value and assigns
// the result to the hosted control's RightToLeft property.
private void OnFlowDirectionChange(object h, String propertyName, object value)
{
    WindowsFormsHost host = h as WindowsFormsHost;
    System.Windows.FlowDirection fd = (System.Windows.FlowDirection)value;
    System.Windows.Forms.CheckBox cb = host.Child as System.Windows.Forms.CheckBox;

    cb.RightToLeft = (fd == System.Windows.FlowDirection.RightToLeft ) ?
        RightToLeft.Yes : RightToLeft.No;
}

// The cb_CheckedChanged method handles the hosted control's
// CheckedChanged event. If the Checked property is true,
// the flow direction is set to RightToLeft, otherwise it is
// set to LeftToRight.
private void cb_CheckedChanged(object sender, EventArgs e)
{
    System.Windows.Forms.CheckBox cb = sender as System.Windows.Forms.CheckBox;

    wfHost.FlowDirection = ( cb.CheckState == CheckState.Checked ) ?
            System.Windows.FlowDirection.RightToLeft :
            System.Windows.FlowDirection.LeftToRight;
}

    ' The ReplaceFlowDirectionMapping method replaces the
' default mapping for the FlowDirection property.
Private Sub ReplaceFlowDirectionMapping()

    wfHost.PropertyMap.Remove("FlowDirection")

    wfHost.PropertyMap.Add( _
        "FlowDirection", _
        New PropertyTranslator(AddressOf OnFlowDirectionChange))
End Sub


' The OnFlowDirectionChange method translates a 
' Windows Presentation Foundation FlowDirection value 
' to a Windows Forms RightToLeft value and assigns
' the result to the hosted control's RightToLeft property.
Private Sub OnFlowDirectionChange( _
ByVal h As Object, _
ByVal propertyName As String, _
ByVal value As Object)

    Dim host As WindowsFormsHost = h

    Dim fd As System.Windows.FlowDirection = _
        CType(value, System.Windows.FlowDirection)

    Dim cb As System.Windows.Forms.CheckBox = host.Child

    cb.RightToLeft = IIf(fd = System.Windows.FlowDirection.RightToLeft, _
        RightToLeft.Yes, _
        RightToLeft.No)

End Sub


' The cb_CheckedChanged method handles the hosted control's
' CheckedChanged event. If the Checked property is true,
' the flow direction is set to RightToLeft, otherwise it is
' set to LeftToRight.
Private Sub cb_CheckedChanged( _
ByVal sender As Object, _
ByVal e As EventArgs)

    Dim cb As System.Windows.Forms.CheckBox = sender

    wfHost.FlowDirection = IIf(cb.CheckState = CheckState.Checked, _
    System.Windows.FlowDirection.RightToLeft, _
    System.Windows.FlowDirection.LeftToRight)

End Sub

    De ReplaceFlowDirectionMapping methode vervangt de standaardtoewijzing voor de FlowDirection eigenschap.

    De OnFlowDirectionChange methode vertaalt de FlowDirection eigenschap naar de eigenschap Windows FormsRightToLeft .

    De cb_CheckedChanged methode behandelt de CheckedChanged gebeurtenis op het CheckBox besturingselement. De FlowDirection eigenschap wordt toegewezen op basis van de waarde van de CheckState eigenschap.

Een standaardeigenschapstoewijzing uitbreiden

U kunt een standaard eigenschapstoewijzing gebruiken en deze uitbreiden met uw eigen toewijzing.

De standaardtoewijzing van eigenschappen uitbreiden

  • Kopieer de volgende code naar de definitie voor de Window1 klasse.

    // The ExtendBackgroundMapping method adds a property
// translator if a mapping already exists.
private void ExtendBackgroundMapping()
{
    if (wfHost.PropertyMap["Background"] != null)
    {
        wfHost.PropertyMap["Background"] += new PropertyTranslator(OnBackgroundChange);
    }
}

// The OnBackgroundChange method assigns a specific image
// to the hosted control's BackgroundImage property.
private void OnBackgroundChange(object h, String propertyName, object value)
{
    WindowsFormsHost host = h as WindowsFormsHost;
    System.Windows.Forms.CheckBox cb = host.Child as System.Windows.Forms.CheckBox;
    ImageBrush b = value as ImageBrush;

    if (b != null)
    {
        cb.BackgroundImage = new System.Drawing.Bitmap(@"C:\WINDOWS\Santa Fe Stucco.bmp");
    }
}

    ' The ExtendBackgroundMapping method adds a property
' translator if a mapping already exists.
Private Sub ExtendBackgroundMapping() 
    If wfHost.PropertyMap("Background") IsNot Nothing Then

        wfHost.PropertyMap("Background") = PropertyTranslator.Combine( _
        wfHost.PropertyMap("Background"), _
        PropertyTranslator.CreateDelegate( _
            GetType(PropertyTranslator), _
            Me, _
            "OnBackgroundChange"))
    End If

End Sub


' The OnBackgroundChange method assigns a specific image 
' to the hosted control's BackgroundImage property.
Private Sub OnBackgroundChange(ByVal h As Object, ByVal propertyName As String, ByVal value As Object) 
    Dim host As WindowsFormsHost = h 
    Dim cb As System.Windows.Forms.CheckBox = host.Child 
    Dim b As ImageBrush = value 
    
    If Not (b Is Nothing) Then
        cb.BackgroundImage = New System.Drawing.Bitmap("C:\WINDOWS\Santa Fe Stucco.bmp")
    End If

End Sub

    Met ExtendBackgroundMapping de methode wordt een aangepaste eigenschapvertaler toegevoegd aan de bestaande Background eigenschapstoewijzing.

    De methode OnBackgroundChange wijst een specifieke afbeelding toe aan de BackgroundImage eigenschap van het gehoste besturingselement. De OnBackgroundChange methode wordt aangeroepen nadat de standaardeigenschapstoewijzing is toegepast.

Uw eigenschapstoewijzingen initialiseren

Stel uw eigenschapstoewijzingen in door de eerder beschreven methoden in de Loaded gebeurtenishandler op te roepen.

Uw eigenschapstoewijzingen initialiseren

  1. Kopieer de volgende code naar de definitie voor de Window1 klasse.

    // The WindowLoaded method handles the Loaded event.
// It enables Windows Forms visual styles, creates
// a Windows Forms checkbox control, and assigns the
// control as the child of the WindowsFormsHost element.
// This method also modifies property mappings on the
// WindowsFormsHost element.
private void WindowLoaded(object sender, RoutedEventArgs e)
{
    System.Windows.Forms.Application.EnableVisualStyles();

    // Create a Windows Forms checkbox control and assign
    // it as the WindowsFormsHost element's child.
    System.Windows.Forms.CheckBox cb = new System.Windows.Forms.CheckBox();
    cb.Text = "Windows Forms checkbox";
    cb.Dock = DockStyle.Fill;
    cb.TextAlign = ContentAlignment.MiddleCenter;
    cb.CheckedChanged += new EventHandler(cb_CheckedChanged);
    wfHost.Child = cb;

    // Replace the default mapping for the FlowDirection property.
    this.ReplaceFlowDirectionMapping();

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

    // Add the mapping for the Clip property.
    this.AddClipMapping();

    // Add another mapping for the Background property.
    this.ExtendBackgroundMapping();

    // Cause the OnFlowDirectionChange delegate to be called.
    wfHost.FlowDirection = System.Windows.FlowDirection.LeftToRight;

    // Cause the OnClipChange delegate to be called.
    wfHost.Clip = new RectangleGeometry();

    // Cause the OnBackgroundChange delegate to be called.
    wfHost.Background = new ImageBrush();
}

    ' The WindowLoaded method handles the Loaded event.
' It enables Windows Forms visual styles, creates 
' a Windows Forms checkbox control, and assigns the
' control as the child of the WindowsFormsHost element. 
' This method also modifies property mappings on the 
' WindowsFormsHost element.
Private Sub WindowLoaded( _
ByVal sender As Object, _
ByVal e As RoutedEventArgs)

    System.Windows.Forms.Application.EnableVisualStyles()

    ' Create a Windows Forms checkbox control and assign 
    ' it as the WindowsFormsHost element's child.
    Dim cb As New System.Windows.Forms.CheckBox()
    cb.Text = "Windows Forms checkbox"
    cb.Dock = DockStyle.Fill
    cb.TextAlign = ContentAlignment.MiddleCenter
    AddHandler cb.CheckedChanged, AddressOf cb_CheckedChanged
    wfHost.Child = cb

    ' Replace the default mapping for the FlowDirection property.
    Me.ReplaceFlowDirectionMapping()

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

    ' Add the mapping for the Clip property.
    Me.AddClipMapping()

    ' Add another mapping for the Background property.
    Me.ExtendBackgroundMapping()

    ' Cause the OnFlowDirectionChange delegate to be called.
    wfHost.FlowDirection = System.Windows.FlowDirection.LeftToRight

    ' Cause the OnClipChange delegate to be called.
    wfHost.Clip = New RectangleGeometry()

    ' Cause the OnBackgroundChange delegate to be called.
    wfHost.Background = New ImageBrush()

End Sub

    De WindowLoaded methode verwerkt de Loaded gebeurtenis en voert de volgende initialisatie uit.

    • Hiermee maakt u een Besturingselement voor Windows FormsCheckBox .

    • Roept de eerder gedefinieerde methoden aan in de walkthrough om de eigenschapstoewijzingen in te stellen.

    • Hiermee worden initiële waarden ingesteld aan de gemapte eigenschappen.

  2. Druk op F5- om de toepassing te bouwen en uit te voeren. Klik op het selectievakje om het effect van de FlowDirection mapping te bekijken. Wanneer u op het selectievakje klikt, wordt de lay-out omgekeerd van links-rechts naar rechts-links.

Zie ook

  • Last updated on