Voir la source de Dependency property

[[Category:WPF]]
= [https://msdn.microsoft.com/en-us/library/ms752914(v=vs.110).aspx Définition] =
Etend une propriété pour qu'elle puisse être définie avec:
* un data binding
* un style
* un trigger
* un behavior
* un visual state
* une animation
Toutes les propriétés des control WPF sont des dependency properties.

= Code =
<kode lang=cs>
public string Text
{
    get => (string)GetValue(TextProperty);
    set => SetValue(TextProperty, value);
}

public static readonly DependencyProperty TextProperty = DependencyProperty.Register(
    nameof(Text),      // le nom de la propriété
    typeof(string),    // le type de la propriété
    typeof(MyControl), // le type de la classe contenant la DependencyProperty
    // la PropertyMetadata
    new FrameworkPropertyMetadata(
        String.Empty,                                          // la valeur par défaut
        FrameworkPropertyMetadataOptions.BindsTwoWayByDefault, // options
        MyControl.OnTextChanged));                             // change handler, appelé à chaque changement de valeur de la propriété

private static void OnTextChanged(DependencyObject d, DependencyPropertyChangedEventArgs e)
{
    var myControl = (MyControl)d;
    var oldValue = (string)e.OldValue;
    var newValue = (string)e.NewValue;

    myControl.OnTextChanged(oldValue, newValue);
}

protected virtual OnTextChanged(string oldValue, string newValue)
{
    ...
}
</kode>

= snippet propdp =
<kode lang='csharp'>
public int MyProperty
{
    get { return (int)GetValue(MyPropertyProperty); }
    set { SetValue(MyPropertyProperty, value); }
}

public static readonly DependencyProperty MyPropertyProperty =
    DependencyProperty.Register(
        "MyProperty", 
        typeof(int), 
        typeof(ownerclass), 
        new PropertyMetadata(0));  // default value
</kode>

= PropertyMetadata, UIPropertyMetadata, FrameworkPropertyMetadata =
Il y a une relation d'héritage entre ces 3 classes : PropertyMetadata &larr; UIPropertyMetadata &larr; FrameworkPropertyMetadata<br/>
*PropertyMetadata : base
*UIPropertyMetadata : permet de définir bool isAnimationProhibited
*FrameworkPropertyMetadata : permet de définir des FrameworkPropertyMetadataOptions et un UpdateSourceTrigger

= Ajout d'une DependencyProperty BindableSource sur le WebBrowser =
<kode lang=csharp>
namespace Mon.Namespace
{
    public static class WebBrowserUtility
    {
        public static readonly DependencyProperty BindableSourceProperty =
            DependencyProperty.RegisterAttached("BindableSource", 
                                                typeof(string), 
                                                typeof(WebBrowserUtility), 
                                                new UIPropertyMetadata(null, BindableSourcePropertyChanged));

        public static string GetBindableSource(DependencyObject obj)
        {
            return (string)obj.GetValue(BindableSourceProperty);
        }

        public static void SetBindableSource(DependencyObject obj, string value)
        {
            obj.SetValue(BindableSourceProperty, value);
        }

        public static void BindableSourcePropertyChanged(DependencyObject o, DependencyPropertyChangedEventArgs e)
        {
            WebBrowser browser = o as WebBrowser;
            if (browser != null)
            {
                string uri = e.NewValue as string;
                browser.Source = !String.IsNullOrEmpty(uri) ? new Uri(uri) : null;
            }
        }
    }
</kode>

<kode lang=xaml>
<Window xmlns:ns="clr-namespace:Mon.Namespace"
    <WebBrowser ns:WebBrowserUtility.BindableSource="{Binding Path=MaPropriété}"/>
</kode>