PropertyMap Classe

Référence

Définition

Espace de noms:: System.Windows.Forms.Integration

Assembly:: WindowsFormsIntegration.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Fournit un moyen de convertir des valeurs de propriété entre les contrôles Windows Forms et les éléments WPF (Windows Presentation Foundation).

public ref class PropertyMap

public class PropertyMap

[System.Security.SecurityCritical]
public class PropertyMap

type PropertyMap = class

[<System.Security.SecurityCritical>]
type PropertyMap = class

Public Class PropertyMap

Héritage: Object
PropertyMap

Attributs: SecurityCriticalAttribute

Exemples

L’exemple de code suivant montre comment ajouter un mappage pour la Margin propriété à un ElementHost contrôle.

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

L’exemple de code suivant montre comment remplacer le mappage par défaut de la FlowDirection propriété sur un WindowsFormsHost contrôle.

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

Remarques

Utilisez la PropertyMap classe pour définir des traductions entre Windows Forms propriétés et Windows Presentation Foundation (WPF) dans une application hybride. Les ElementHost.PropertyMap propriétés et WindowsFormsHost.PropertyMap les propriétés des classes et WindowsFormsHost des ElementHost classes définissent des mappages d’une technologie à l’autre.

Pour plus d’informations, consultez Procédure pas à pas : mappage des propriétés à l’aide du contrôle ElementHost et de la procédure pas à pas : propriétés de mappage à l’aide de l’élément WindowsFormsHost.

Constructeurs

PropertyMap()	Initialise une nouvelle instance de la classe PropertyMap.
PropertyMap(Object)	Initialise une nouvelle instance de la classe PropertyMap avec l’objet source indiqué.

Propriétés

DefaultTranslators	Obtient une collection de mappages de propriété qui sont définis par défaut.
Item[String]	Obtient ou définit le délégué PropertyTranslator pour la propriété donnée.
Keys	Obtient un objet ICollection contenant les noms de propriété de la collection PropertyMap.
SourceObject	Obtient l’objet dont les propriétés doivent être converties.
Values	Obtient un ICollection contenant les convertisseurs de propriété de la collection PropertyMap.

Méthodes

Add(String, PropertyTranslator)	Ajoute un délégué PropertyTranslator pour la propriété donnée à la PropertyMap.
Apply(String)	Exécute le convertisseur de propriété pour la propriété donnée, selon la valeur actuelle de la propriété de l’objet source.
ApplyAll()	Exécute le convertisseur de propriété pour chaque propriété mappée, selon les valeurs de propriété actuelles de l’objet source.
Clear()	Supprime tous les mappages de propriété.
Contains(String)	Obtient une valeur indiquant si la propriété donnée est mappée.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Remove(String)	Supprime la propriété donnée du mappage.
Reset(String)	Restaure le mappage de propriété par défaut pour la propriété donnée.
ResetAll()	Restaure les mappages de propriété par défaut.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Événements

PropertyMappingError

Se produit quand une exception est levée par un traducteur de propriété.

S’applique à