WPF-利用装饰器实现空间的自由拖动

历

　　在项目中经常会遇到类似如下要求的需求，创建允许自由拖动的控件，这样的需求可以使用WPF的装饰器Adorner来实现。

 
一、什么是装饰器？

装饰器是一种特殊类型的FrameworkElement，装饰器始终呈现在被装饰元素的顶部，用于向用户提供可视化提示。装饰器可以在不改变原有控件结构的基础上，将功能点增加到元素中或元素上提供视觉效果等，如WPF的光标效果，焦点效果等都是通过装饰器来实现的。装饰器是一个始终位于装饰元素或装饰元素集合顶部的呈现图层，其呈现独立与它所绑定的UIElement，WPF中的装饰器是在一个单独的曾AnornerLayer上进行绘制的，该层位于普通控件元素之上，而且允许多个AdornerLayer进行叠加，当加入AdornerLayer层后，Adorner会默认使用其所装饰元素的左上角作为原点进行定位。

• Adorner 是一个抽象类，所有装饰器的实现都需要继承此类，比如ThumbBorderAdorner
  
• AdornerLayer 一个类，表示一个或多个装饰元素的装饰器呈现层
  
  
  
  • 利用AdornerLayer adornerLayer = AdornerLayer.GetAdornerLayer(userControl)函数，来获取指定控件是否有装饰器布局层
    
  • 利用Adorner[] adorners = adornerLayer.GetAdorners(userControl);，来查看当前控件的装饰器个数
    
  
  
• AdornerDecorator 一个类，为可视化树中的子元素提供AdornerLayer
  

二、装饰器的使用场景

• 为现有的元素添加额外的装饰，如为Border添加8个装饰矩形
  

 三、如何创建自定义的装饰器？

• 创建一个类，继承自Adorner类
  
• 重写此类中需要的函数
  
  
  
  • OnRender(DrawingContext drawingContext) 在派生类中重写，参与由布局系统控制的呈现操作，调用此方法时，不直接使用此元素的呈现指令，而是将其保留供布局和绘制在以后异步使用，可以使用drawingContext 来绘制各种形状以及图形。
    
  • ArrangeOverride() 为FrameworkElement派生类定位子元素并确定大小，在其中调用Arrange()函数，来定位子元素
    
  • GetVisualChild() //获取第几个Thumb控件，在构造时使用
    
  
  
• 简单的装饰可以重写OnRender()函数，在其中绘制所需要的装饰，参照BorderAdorner
  
• 复杂一些的如需要可以定义VisualCollection的集合来存放装饰器，重写ArrangeOverride和GetVisualChild函数来实现，参照ThumbBorderAdorner
  

 四、给控件使用自定义的Adorner

• 添加Adorner
  

1. AdornerLayer adornerLayer = AdornerLayer.GetAdornerLayer(userControl);
2. if (adornerLayer != null)
3. {
4.     Adorner[] adorners = adornerLayer.GetAdorners(userControl);
5.     if (adorners == null || adorners.Count() == 0)
6.     {
7.         adornerLayer.Add(new ThumbBorderAdorner(userControl)
8.         {
9.             DragCompletedAction = ThumbBorderAdornerDragCompletedActionFunc
10.         });
11.     }
12. }

复制代码

 

• 移除 Adorner
  

1. AdornerLayer adornerLayer = AdornerLayer.GetAdornerLayer(userControl);
2. if (adornerLayer != null)
3. {
4.     Adorner[] adorners = adornerLayer.GetAdorners(userControl);
5.     if (adorners != null && adorners.Count() > 0)
6.         adornerLayer.Remove(adorners[0]);
7. }

复制代码

 
五、处理拖拽Thumb时，导致控件范围超出父级容器的情况

• 即在添加装饰器的控件中添加UserControl_SizeChanged()来处理控件大小和和未知变化
  

1. private void UserControl_SizeChanged(object sender, SizeChangedEventArgs e)
2. {
3.     int tempMargin = 1;  //MarkRectUserControl控件始终在父级容器的1个像素以内
5.     double left = Canvas.GetLeft(this);
6.     if (left < tempMargin)
7.     {
8.         left = tempMargin;
9.         Canvas.SetLeft(this, left);
10.     }
12.     double top = Canvas.GetTop(this);
13.     if (top < tempMargin)
14.     {
15.         top = tempMargin;
16.         Canvas.SetTop(this, top);
17.     }
19.     if (left + this.ActualWidth > canvasParent.ActualWidth - tempMargin)
20.         this.Width = canvasParent.ActualWidth - tempMargin - left;
22.     if (top + this.ActualHeight > canvasParent.ActualHeight - tempMargin)
23.         this.Height = canvasParent.ActualHeight - tempMargin - top;
25. }

复制代码

 
六、测试使用

 

1. <UserControl x:Class="BlogDemo.Views.AdornerTestUserControl"
2.              xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
3.              xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
4.              xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
5.              xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
6.              xmlns:local="clr-namespace:BlogDemo.Views"
7.              mc:Ignorable="d"
8.              Background="White"
9.              d:DesignHeight="450" d:DesignWidth="800"
10.              FontSize="20"
11.              Foreground="Blue"
12.              Loaded="UserControl_Loaded"
13.              >
14.     <Grid>
15.         <Grid.RowDefinitions>
16.             <RowDefinition Height="Auto"/>
17.             <RowDefinition Height="*"/>
18.         </Grid.RowDefinitions>
19.         
20.         <TextBlock Text="请拖拽Thumb控件来改变，控件大小。" HorizontalAlignment="Center" Margin="10"/>
22.         <Canvas x:Name="Canvas_Main" Grid.Row="1">
23.             <Border x:Name="Border_Text" Canvas.Left="200" Canvas.Top="100" Width="200" Height="100" BorderThickness="2" BorderBrush="Green" SizeChanged="Border_Text_SizeChanged"/>
24.         </Canvas>
25.     </Grid>
26. </UserControl>

复制代码

1. /// <summary>
2. /// AdornerTestUserControl.xaml 的交互逻辑
3. /// </summary>
4. public partial class AdornerTestUserControl : UserControl
5. {
6.     public AdornerTestUserControl()
7.     {
8.         InitializeComponent();
9.     }
11.     private void UserControl_Loaded(object sender, RoutedEventArgs e)
12.     {
13.         AdornerLayer adornerLayer = AdornerLayer.GetAdornerLayer(Border_Text);
14.         if (adornerLayer != null)
15.         {
16.             Adorner[] adorners = adornerLayer.GetAdorners(Border_Text);
17.             if (adorners == null || adorners.Count() == 0)
18.             {
19.                 adornerLayer.Add(new ThumbBorderAdorner(Border_Text));
20.             }
21.         }
22.     }
24.     private void Border_Text_SizeChanged(object sender, SizeChangedEventArgs e)
25.     {
26.         int tempMargin = 100;
28.         double left = Canvas.GetLeft(Border_Text);
29.         if (left < tempMargin)
30.         {
31.             left = tempMargin;
32.             Canvas.SetLeft(Border_Text, left);
33.         }
35.         double top = Canvas.GetTop(Border_Text);
36.         if (top < tempMargin)
37.         {
38.             top = tempMargin;
39.             Canvas.SetTop(Border_Text, top);
40.         }
42.         if (Border_Text.ActualWidth < tempMargin)
43.             Border_Text.Width = tempMargin;
45.         if (Border_Text.ActualHeight < tempMargin)
46.             Border_Text.Height = tempMargin;
48.         if (left + Border_Text.ActualWidth > Canvas_Main.ActualWidth - tempMargin)
49.             Border_Text.Width = Canvas_Main.ActualWidth - tempMargin - left;
51.         if (top + Border_Text.ActualHeight > Canvas_Main.ActualHeight - tempMargin)
52.             Border_Text.Height = Canvas_Main.ActualHeight - tempMargin - top;
53.     }
54. }

复制代码

 
 
源码地址:https://gitee.com/LiuShuiRuoBing/code_blog
 
 
来源:https://www.cnblogs.com/liushuiruobing/archive/2023/08/25/17656703.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！