WPF自定义控件的三种方式

Posted 2021-10-08 阿里云云栖号

简介： 某些场景下，我们确实需要创建新的控件。此时，理解 WPF不同控件的创建方法就显得非常重要。 WPF 提供3个用于创建控件的方法，每个方法都提供不同的灵活度。

WPF控件可以通过数据模型（DataTemplate）、样式(Style)、控件模板（ControlTemplate)和触发器(Trigger)等机制减少创建新控件的需要。 但是，某些场景下，我们确实需要创建新的控件。此时，理解 WPF不同控件的创建方法就显得非常重要。 WPF 提供3个用于创建控件的方法，每个方法都提供不同的灵活度，下面分别进行介绍。

1 基于UserControl 创建

创建控件最简单一个方法就是基于UserControl 类进行继承。此时，我们可以将WPF中现有组件添加到 UserControl 画布上来，并将各组件进行命名，这样可以在后台进行组件访问和使用事件处理程序。 UserControl 可以利用丰富内容、样式和触发器的优点。 但是，继承自 UserControl的控件，将无法使用 DataTemplate 或 ControlTemplate 来自定义UI外观。

2  基于Control 创建

基于Control类创建自定义控件的方法 ，可以使用模板定义UI外观。而且可以将后台逻辑和前端样式展现上进行分离。 另外，这种方法创建的自定义控件，还支持使用命令和绑定来完成相关动作，实现类似事件的效果。最后，控件可以重新定义ControlTemplate和DataTemplate来自定义UI外观。控件支持不同的主题。

3 基于 FrameworkElement 创建

   一般来说，基于 UserControl 或 Control 创建的自定义控件即可完成业务需求，但是，在一些特殊情况下，简单的元素组合不能满足自定义控件的UI外观要求。此时，基于FrameworkElement 创建自定义控件是一个很好的选择。

基于FrameworkElement创建控件，一方面可以通过重写的 OnRender 方法进行UI的直接绘制。 另一方面，可以通过自定义元素组合来可视化编写组件的外观。

4 依赖属性

WPF 可以通过设置控件的属性来更改其外观和行为。其中的依赖属性可以让自定义控件执行以下操作：

• 在样式中设置该属性。
• 将该属性绑定到数据源。
• 使用动态资源作为该属性的值。
• 对该属性进行动画处理。

如果控件的属性支持以上任一功能，应将该属性实现为依赖属性。 下面给出一个微软官方文档的示例程序：

/// <summary>
/// Identifies the Value dependency property.
/// </summary>
public static readonly DependencyProperty ValueProperty =
    DependencyProperty.Register(
        "Value", typeof(decimal), typeof(NumericUpDown),
        new FrameworkPropertyMetadata(MinValue, new PropertyChangedCallback(OnValueChanged),
                                      new CoerceValueCallback(CoerceValue)));

/// <summary>
/// Gets or sets the value assigned to the control.
/// </summary>
public decimal Value
{
    get { return (decimal)GetValue(ValueProperty); }
    set { SetValue(ValueProperty, value); }
}

private static object CoerceValue(DependencyObject element, object value)
{
    decimal newValue = (decimal)value;
    NumericUpDown control = (NumericUpDown)element;

    newValue = Math.Max(MinValue, Math.Min(MaxValue, newValue));

    return newValue;
}

private static void OnValueChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)
{
    NumericUpDown control = (NumericUpDown)obj;         

    RoutedPropertyChangedEventArgs<decimal> e = new RoutedPropertyChangedEventArgs<decimal>(
        (decimal)args.OldValue, (decimal)args.NewValue, ValueChangedEvent);
    control.OnValueChanged(e);
}

此示例代码来自官网控件创作概述 - WPF .NET Framework | Microsoft Docs ，其中定义一个名为 ValueProperty的依赖属性（DependencyProperty ），通过调用DependencyProperty.Register向属性系统注册属性名称Value，其中包含了三个核心信息：

• 属性的名称Value
• 属性的类型decimal
• 拥有属性的类型NumericUpDown
• 属性元数据信息（FrameworkPropertyMetadata）

其中，属性的元数据包含属性的默认值， CoerceValueCallback 和 PropertyChangedCallback 。 CoerceValue 确保 Value 大于或等于 MinValue 且小于或等于 MaxValue。另外，PropertyChangedCallback 回调方法为 OnValueChanged ，来处理属性值变化的相关逻辑，后面通过RoutedPropertyChangedEventArgs创建了一个路由事件，并通过control.OnValueChanged(e)来进行触发。

原文链接
本文为阿里云原创内容，未经允许不得转载。