WPF依赖项属性

Question

我很难理解WPF中的依赖属性，可能是因为我要找的用例非常具体，没有很好的文档化。

我有一个自定义控件，看起来像这样（请忽略所有可怕的代码，这是暂时的！）：

<UserControl x:Class="HydroAccessory.Controls.FillGraph"
         xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
         xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
         xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
         xmlns:local="clr-namespace:HydroAccessory.Controls"
         mc:Ignorable="d"
         SizeChanged="FillGraph_SizeChanged"
         d:DesignHeight="200" d:DesignWidth="300">
<Grid>

    <TextBlock x:Name="PercentageTB" Text="Fill Percentage: 0%" />

</Grid>

我这样称呼它在我的主窗口内：

<controls:FillGraph x:Name="HydroModel" />

using System;
using System.Windows;
using System.Windows.Controls;

namespace HydroAccessory.Controls
{
public partial class FillGraph : UserControl
{
    private float percentage;
    public float Percentage
    {
        get
        {
            return percentage;
        }
        set
        {
            percentage = value;
            PercentageTB.Text = String.Format("Fill Percentage: {0}", percentage.ToString() + "%");
        }
    }

    public FillGraph()
    {
        InitializeComponent();
    }
}
}

我只想在主窗口中的自定义控件调用中说：

<controls:FillGraph x:Name="HydroModel" Percentage="{Binding FillPercentage}" />

（其中fillPercent是另一个脚本中不需要担心的内容）。该控件将被展开，因此需要保持为自定义控件。我明白我可能需要依赖属性，但在尝试了许多不同的方法后，我无法弄清楚如何完成这个看似简单的任务。感谢帮助。

Answer 1

代码中没有依赖项属性。

这是一个依赖项属性：

public partial class FillGraph : UserControl
{
    public FillGraph()
    {
        InitializeComponent();
    }

    public float Percentage
    {
        get { return (float)GetValue(PercentageProperty); }
        set { SetValue(PercentageProperty, value); }
    }

    //  Using a DependencyProperty as the backing store for Percentage.  This 
    //  enables animation, styling, binding, etc...
    public static readonly DependencyProperty PercentageProperty =
        DependencyProperty.Register("Percentage", typeof(float), 
                typeof(FillGraph), new PropertyMetadata(0.0f));
}

正如Ayyappan Subramanian所建议的，Visual Studio中的propdp代码段将有助于创建样板文件。只要小心传递给DependencyProperty.Register()的参数，并确保传递给New PropertyMetadata()的默认值是正确的类型。0.0f是浮点数。如果为float属性传递整数0，它将在运行时引发异常。

<Grid>
    <TextBlock 
        Text="{Binding Percentage, RelativeSource={RelativeSource AncestorType=UserControl}, StringFormat='Fill Percentage: {0:#.##}%'}" 
        />
</Grid>

    <TextBlock 
        Text="{Binding Percentage, StringFormat='Fill Percentage: {0:p2}', RelativeSource={RelativeSource AncestorType=UserControl}}" 
        />

<controls:FillGraph x:Name="HydroModel" Percentage="{Binding FillPercentage}" />