WPF中用户控件和自定义控件

简介: 无论是在WPF中还是WinForm中,都有用户控件(UserControl)和自定义控件(CustomControl),这两种控件都是对已有控件的封装,实现功能重用。但是两者还是有一些区别,本文对这两种控件进行讲解。

WPF中用户控件和自定义控件

无论是在WPF中还是WinForm中,都有用户控件(UserControl)和自定义控件(CustomControl),这两种控件都是对已有控件的封装,实现功能重用。但是两者还是有一些区别,本文对这两种控件进行讲解。

  1. 用户控件
  • 注重复合控件的使用,也就是多个现有控件组成一个可复用的控件组
  • XAML和后台代码组成,绑定紧密
  • 不支持模板重写
  • 继承自UserControl
  1. 自定义控件
  • 完全自己实现一个控件,如继承现有控件进行功能扩展,并添加新功能
  • 后台代码和Generic.xaml进行组合
  • 在使用时支持模板重写
  • 继承自Control

用户控件

用户控件比较容易理解,与常见的WPF窗体类似,值得注意一点的地方是内部在使用绑定的时候,需要使用RelativeSource的方式来绑定,以实现良好的封装。一个简单的案例:

  • 定义用户控件

<UserControl

   x:Class="WpfApp19.UserControl1"

   xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

   xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

   xmlns:d="http://schemas.microsoft.com/expression/blend/2008"

   xmlns:local="clr-namespace:WpfApp19"

   xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"

   d:DesignHeight="450"

   d:DesignWidth="800"

   mc:Ignorable="d">

   <Grid>

       <!--下面绑定都要用RelativeSource作为源-->

       <StackPanel>

           <TextBox

               Width="100"

               BorderThickness="2"

               Text="{Binding value, RelativeSource={RelativeSource AncestorType=UserControl}}"/>

           <Button

               Width="100"

               Command="{Binding Command, RelativeSource={RelativeSource AncestorType=UserControl}}"

               Content="Ok"/>

       </StackPanel>

   </Grid>

</UserControl>

后台代码

//根据需要定义依赖属性

//所需要绑定的值

publicintvalue

{

    get { return (int)GetValue(valueProperty); }

    set { SetValue(valueProperty, value); }

}

publicstaticreadonlyDependencyPropertyvalueProperty=

    DependencyProperty.Register("value", typeof(int), typeof(UserControl1), newPropertyMetadata(0));

//所需要绑定的命令

publicICommandCommand

{

    get { return (ICommand)GetValue(CommandProperty); }

    set { SetValue(CommandProperty, value); }

}

publicstaticreadonlyDependencyPropertyCommandProperty=

    DependencyProperty.Register("Command", typeof(ICommand), typeof(UserControl1), newPropertyMetadata(default(ICommand)));

//所需要绑定的命令参数

publicobjectCommandParemeter

{

    get { return (object)GetValue(CommandParemeterProperty); }

    set { SetValue(CommandParemeterProperty, value); }

}

publicstaticreadonlyDependencyPropertyCommandParemeterProperty=

    DependencyProperty.Register("CommandParemeter", typeof(object), typeof(UserControl1), newPropertyMetadata(0));

  • 使用用户控件

<Windowx:Class="WpfApp19.MainWindow"

       ...

       xmlns:local="clr-namespace:WpfApp19"

       Title="MainWindow"Height="450"Width="800">

   <Grid>

       <local:UserControl1value="{Binding }"Command="{Binding }"/>

   </Grid>

</Window>

自定义控件

点击添加自定义控件后,会增加一个CustomControl1.cs文件以及一个Themes目录,在该目录下有一个Generic.xaml文件,该文件就是自定义控件的style。我们经常针对某些控件进行编辑模板-创建副本的操作而产生的style,其实就是Generic.xaml中定义的style。另外,有时我们可能遇到一种情况,也就是相同的软件在不同的Windows版本下运行,表现形式可能会不同,甚至某些系统下运行不了,这就是和不同系统下的默认的Theme不同。其实wpf控件找不到自定义的样式时,会从系统获取样式,查找顺序是,先查找所在的程序集,如果程序集定义了ThemeInfo特性,那么会查看ThemeInfoDictionaryLocation的属性值,该属性如果是None则说明没有特定的主题资源,值为SourceAssembly,说明特定资源定义在程序集内部,值为ExternalAssembly则说明在外部,如果还是没有找到,则程序会在自身的themes/generic.xaml中获取,在generic.xaml中获取的其实就和系统默认样式相关。

不同xaml所对应的系统主题

按钮案例

C#文件

publicclassSwitch : ToggleButton

{

   staticSwitch()

   {

       //通过重写Metadata,控件就会通过程序集themes文件夹下的generic.xaml来寻找系统默认样式

       DefaultStyleKeyProperty.OverrideMetadata(typeof(Switch), newFrameworkPropertyMetadata(typeof(Switch)));

   }

}

Themes文件夹下的Generic.xaml文件

注意在该文件中不能有中文,注释也不行

<StyleTargetType="{x:Type local:Switch}">

   <SetterProperty="Template">

       <Setter.Value>

           <ControlTemplateTargetType="{x:Type local:Switch}">

               <Grid>

                   <Border

                       Name="dropdown"

                       Width="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}"

                       Margin="-23"

                       CornerRadius="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}"

                       Visibility="Collapsed">

                       <Border.Background>

                           <RadialGradientBrush>

                               <GradientStopOffset="1"Color="Transparent"/>

                               <GradientStopOffset="0.7"Color="#5500D787"/>

                               <GradientStopOffset="0.59"Color="Transparent"/>

                           </RadialGradientBrush>

                       </Border.Background>

                   </Border>

                   <Border

                       Name="bor"

                       Width="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}"

                       Background="Gray"

                       BorderBrush="DarkGreen"

                       BorderThickness="5"

                       CornerRadius="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}">

                       <Border

                           Name="bor1"

                           Width="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}"

                           Margin="2"

                           Background="#FF00C88C"

                           CornerRadius="{Binding RelativeSource={RelativeSource Self}, Path=ActualHeight}"/>

                   </Border>

               </Grid>

               <ControlTemplate.Triggers>

                   <TriggerProperty="IsChecked"Value="True">

                       <Trigger.EnterActions>

                           <BeginStoryboard>

                               <Storyboard>

                                   <ColorAnimation

                                       Storyboard.TargetName="bor1"

                                       Storyboard.TargetProperty="Background.Color"

                                       To="White"

                                       Duration="0:0:0.5"/>

                                   <ColorAnimation

                                       Storyboard.TargetName="bor"

                                       Storyboard.TargetProperty="BorderBrush.Color"

                                       To="#FF32FAC8"

                                       Duration="0:0:0.5"/>

                                   <ObjectAnimationUsingKeyFramesStoryboard.TargetName="dropdown"Storyboard.TargetProperty="Visibil

                                       <DiscreteObjectKeyFrame KeyTime="0:0:0.3">

                                           <DiscreteObjectKeyFrame.Value>

                                               <Visibility>Visible</Visibility>

                                           </DiscreteObjectKeyFrame.Value>

                                       </DiscreteObjectKeyFrame>

                                   </ObjectAnimationUsingKeyFrames>

                               </Storyboard>

                           </BeginStoryboard>

                       </Trigger.EnterActions>

                       <Trigger.ExitActions>

                           <BeginStoryboard>

                               <Storyboard>

                                   <ColorAnimation Storyboard.TargetName="bor1" Storyboard.TargetProperty="Background.Color" />

                                   <ColorAnimation Storyboard.TargetName="bor" Storyboard.TargetProperty="BorderBrush.Color" />

                                   <ObjectAnimationUsingKeyFrames Storyboard.TargetName="dropdown" Storyboard.TargetProperty="Visibil

                                       <DiscreteObjectKeyFrame KeyTime="0:0:0.3">

                                           <DiscreteObjectKeyFrame.Value>

                                               <Visibility>Collapsed</Visibility>

                                           </DiscreteObjectKeyFrame.Value>

                                       </DiscreteObjectKeyFrame>

                                   </ObjectAnimationUsingKeyFrames>

                               </Storyboard>

                           </BeginStoryboard>

                       </Trigger.ExitActions>

                   </Trigger>

               </ControlTemplate.Triggers>

           </ControlTemplate>

       </Setter.Value>

   </Setter>

</Style>

使用自定控件

<Grid>

   <local:SwitchWidth="100"Height="100"/>

</Grid>

自定义控件中常用的知识点

  1. TemplatePart特性

在自定义控件中,有些控件是需要有名称的以便于调用,如在重写的OnApplyTemplate()方法中得到指定的button。这就要求用户在使用控件时,不能够修改模板中的名称。

//应用该控件时调用

publicoverridevoidOnApplyTemplate()

{

   UpButtonElement=GetTemplateChild("UpButton") asRepeatButton;

   DownButtonElement=GetTemplateChild("DownButton") asRepeatButton;

}

所以在类前面使用特性进行标注

[TemplatePart(Name="UpButton", Type=typeof(RepeatButton))]

[TemplatePart(Name="DownButton", Type=typeof(RepeatButton))]

publicclassNumeric : Control{}

  1. 视觉状态的定义与调用

自定义控件中可以定义视觉状态来呈现不同状态下的效果。

在xml中定义视觉状态,不同组下的视觉状态是互斥的

<VisualStateManager.VisualStateGroups>

   <VisualStateGroupName="FocusStates">

       <VisualStateName="Focused">

           <Storyboard>

               <ObjectAnimationUsingKeyFramesStoryboard.TargetName="FocusVisual"

                          Storyboard.TargetProperty="Visibility"Duration="0">

                   <DiscreteObjectKeyFrameKeyTime="0">

                       <DiscreteObjectKeyFrame.Value>

                           <Visibility>Visible</Visibility>

                       </DiscreteObjectKeyFrame.Value>

                   </DiscreteObjectKeyFrame>

               </ObjectAnimationUsingKeyFrames>

           </Storyboard>

       </VisualState>

       <VisualStateName="Unfocused"/>

   </VisualStateGroup>

</VisualStateManager.VisualStateGroups>

在C#中对应视觉状态的切换

privatevoidUpdateStates(booluseTransitions)

{

   if (IsFocused)

   {

       VisualStateManager.GoToState(this, "Focused", false);

   }

   else

   {

       VisualStateManager.GoToState(this, "Unfocused", false);

   }

}

同时可以在后台类中使用特性来标注

[TemplateVisualState(Name="Focused", GroupName="FocusedStates")]

[TemplateVisualState(Name="Unfocused", GroupName="FocusedStates")]

publicclassNumeric : Control{}

其实完全可以使用Trigger来实现该功能

案例学习源码下载

分享几个用户控件和自定义控件的案例,效果如下:

源码下载

相关文章
|
7月前
|
C# 开发者 Windows
基于Material Design风格开源、易用、强大的WPF UI控件库
基于Material Design风格开源、易用、强大的WPF UI控件库
398 0
|
7月前
|
C#
浅谈WPF之装饰器实现控件锚点
使用过visio的都知道,在绘制流程图时,当选择或鼠标移动到控件时,都会在控件的四周出现锚点,以便于修改大小,移动位置,或连接线等,那此功能是如何实现的呢?在WPF开发中,想要在控件四周实现锚点,可以通过装饰器来实现,今天通过一个简单的小例子,简述如何在WPF开发中,应用装饰器,仅供学习分享使用,如有不足之处,还请指正。
154 1
|
C# Windows
WPF技术之RichTextBox控件
WPF RichTextBox是Windows Presentation Foundation (WPF)中提供的一个强大的文本编辑控件,它可以显示富文本格式的文本,支持多种文本处理操作。
619 0
|
4月前
|
开发框架 缓存 前端开发
循序渐进介绍基于CommunityToolkit.Mvvm 和HandyControl的WPF应用端开发(11) -- 下拉列表的数据绑定以及自定义系统字典列表控件
循序渐进介绍基于CommunityToolkit.Mvvm 和HandyControl的WPF应用端开发(11) -- 下拉列表的数据绑定以及自定义系统字典列表控件
|
4月前
|
C# 开发者 Windows
一款基于Fluent设计风格、现代化的WPF UI控件库
一款基于Fluent设计风格、现代化的WPF UI控件库
113 1
|
4月前
|
C# Windows
WPF中如何使用HandyCotrol控件库
WPF中如何使用HandyCotrol控件库
208 1
|
4月前
|
C# 前端开发 UED
WPF数据验证实战:内置控件与自定义规则,带你玩转前端数据验证,让你的应用程序更上一层楼!
【8月更文挑战第31天】在WPF应用开发中,数据验证是确保输入正确性的关键环节。前端验证能及时发现错误,提升用户体验和程序可靠性。本文对比了几种常用的WPF数据验证方法,并通过示例展示了如何使用内置验证控件(如`TextBox`)及自定义验证规则实现有效验证。内置控件结合`Validation`类可快速实现简单验证;自定义规则则提供了更灵活的复杂逻辑支持。希望本文能帮助开发者更好地进行WPF数据验证。
151 0
|
4月前
|
C# UED 定位技术
WPF控件大全:初学者必读,掌握控件使用技巧,让你的应用程序更上一层楼!
【8月更文挑战第31天】在WPF应用程序开发中,控件是实现用户界面交互的关键元素。WPF提供了丰富的控件库,包括基础控件(如`Button`、`TextBox`)、布局控件(如`StackPanel`、`Grid`)、数据绑定控件(如`ListBox`、`DataGrid`)等。本文将介绍这些控件的基本分类及使用技巧,并通过示例代码展示如何在项目中应用。合理选择控件并利用布局控件和数据绑定功能,可以提升用户体验和程序性能。
83 0
|
4月前
|
开发框架 前端开发 JavaScript
WPF应用开发之控件动态内容展示
WPF应用开发之控件动态内容展示
|
4月前
|
开发框架 前端开发 JavaScript
循序渐进介绍基于CommunityToolkit.Mvvm 和HandyControl的WPF应用端开发(3)--自定义用户控件
循序渐进介绍基于CommunityToolkit.Mvvm 和HandyControl的WPF应用端开发(3)--自定义用户控件