装饰器体系结构

项目
05/28/2012

[本文档仅供预览，在以后的发行版中可能会发生更改。包含的空白主题用作占位符。]

可视化设计体验需要装饰器，装饰器是设计图面上的特殊标志符号。装饰器通常附加到目标控件，可让用户以图形化方式调整控件的属性。例如，当设计控件时，您会单击控件的一角来调整其大小，您单击的大小调整标志符号就是一个装饰器。

对于 WPF Designer体系结构来说，能够快速轻松地绘制、完善装饰器，以及重新设置装饰器的样式意义重大。本概述介绍 WPF Designer装饰器扩展性模型如何使您轻松地创建自己的装饰器来获得自定义控件设计体验。

WPF Designer为显示装饰器提供了灵活的机制。此机制与一个灵活的命令系统关联，使装饰器可以响应用户输入。可以通过实现 IProvideAttributeTable 接口向控件中添加装饰器。

装饰器类型

装饰器几乎可以为所有可视化设计时表示形式建模，但某些装饰器类型出现得更加频繁。下表描述常用装饰器。

装饰器	说明
抓取句柄	允许移动和调整控件大小；不可缩放。
轨道	沿控件一侧添加一个标记或标尺；不可沿单个轴缩放。
框架	表示控件的边界；沿两个轴缩放。
覆盖	在控件区域中捕获鼠标交互；沿两个轴缩放。大体上等效于 System.ComponentModel 设计器框架中的主体标志符号。

装饰器特征

WPF Designer框架启用的装饰器具有下列特征。

允许装饰器从任何 UIElement 类派生并支持 Windows Presentation Foundation 样式。
允许为水平和垂直维度独立指定所有大小、位置和缩放。
不需要装饰器基类。装饰器类型可以从满足需要的任何 UIElement 类型派生。

创建自定义装饰器

装饰器由 AdornerProvider 功能提供程序提供。可以向类添加 AdornerProvider 功能，它会自动将装饰器添加到设计图面中。下面的演练演示如何创建自定义装饰器。

装饰器扩展性

装饰器是根据装饰器提供程序的策略来添加的。可以通过向类定义中添加 UsesItemPolicyAttribute 来向 AdornerProvider 中添加策略。

当 IsInPolicy 检查通过时，装饰器将显示在设计图面上。

可以向控件添加装饰器提供程序，此控件为给定策略提供装饰器。当策略中的项更改时，装饰器功能连接器在新控件上查询新的装饰器提供程序，并显示更新的装饰器集。

WPF Designer实现 PrimarySelectionAdornerProvider，它提供一组为主选项显示的装饰器。大多数自定义装饰器提供程序从此类派生。

装饰器和布局

装饰器最重要的问题是布局。装饰器需要各种布局选项。当为设计器图面更改缩放设置时，必须考虑装饰器的特定拉伸或缩放行为。装饰器必须能够根据下面的方案调整自身的大小和位置。

相对于应用的样式。
相对于所装饰控件的大小和位置。
相对于绝对像素偏移量。
相对于当前缩放设置。

在 WPF 中，控制布局的典型机制是面板。 WPF Designer框架通过将 AdornerPanel 类用于设计图面上给定控件的父装饰器来控制布局。

AdornerPanel 类提供的方法允许相对于所装饰的控件来调整装饰器的大小和放置装饰器。若要指定装饰器的位置，请使用 SetAdornerHorizontalAlignment、SetAdornerVerticalAlignment 和 SetAdornerMargin 方法。

备注

在添加一个控件作为另一个控件的装饰器时，将会排列装饰器控件以匹配它所装饰控件的宽度、高度和转换。这可能会导致剪裁问题。这些剪裁问题的最简单解决方法是：将控件添加到 Canvas，然后添加画布作为装饰器。将调整 Canvas 的宽度和高度，但 Canvas 控件不会剪裁或根据内容调整大小，因此只会在画布内排列控件。

下面的代码示例演示如何在目标控件上定位装饰器。

' Setup the adorner panel.
' All adorners are placed in an AdornerPanel
' for sizing and layout support.
Dim myPanel = Me.Panel

' The slider extends the full width of the control it adorns.
AdornerPanel.SetAdornerHorizontalAlignment( _
    opacitySlider, _
    AdornerHorizontalAlignment.Stretch)

' Position the adorner above the control it adorns.
AdornerPanel.SetAdornerVerticalAlignment( _
    opacitySlider, _
    AdornerVerticalAlignment.OutsideTop)

' Position the adorner 5 pixels above the control. 
AdornerPanel.SetAdornerMargin( _
    opacitySlider, _
    New Thickness(0, 0, 0, 5))

// Setup the adorner panel.
// All adorners are placed in an AdornerPanel
// for sizing and layout support.
AdornerPanel myPanel = this.Panel;

// The slider extends the full width of the control it adorns.
AdornerPanel.SetAdornerHorizontalAlignment( 
    opacitySlider, 
    AdornerHorizontalAlignment.Stretch);

// Position the adorner above the control it adorns.
AdornerPanel.SetAdornerVerticalAlignment(
    opacitySlider, 
    AdornerVerticalAlignment.OutsideTop);

// Position the adorner 5 pixels above the control. 
AdornerPanel.SetAdornerMargin(
    opacitySlider, 
    new Thickness(0, 0, 0, 5));

缩放行为

当设计器视图的缩放设置更改为 200% 时，所装饰控件以实际大小的两倍呈现。所有距离和字体更大，线条更粗。许多装饰器设计指定装饰器保留它们的原始大小，即使设计器视图缩放更改时也是如此。

DesignerView

DesignerView 类提供了一个装饰器集合，并将所有用户输入映射到设计器操作。 DesignerView 类是从 Decorator 类派生的。它为设计器提供一个可视化图面。将设计器 UI 的根元素分配给 DesignerView 的 Child 属性，并在设计器视图上设置编辑上下文属性，使其指向设计器的编辑上下文。

DesignerView view = new DesignerView();
view.Child = documentManager.View;
view.Context = editingContext;

DesignerView 类实现 WPF Designer的两个方面。

装饰器

DesignerView 类支持在视图中使用其他可视化装饰（这些装饰会覆盖正在设计的控件）来装饰元素。

输入传送

DesignerView 类将用户输入传送给装饰器、工具和任务中的命令。

DesignerView 类通过在所有内容前面引入两个附加元素（即装饰器层和命中测试层）来工作。下图演示设计器视图层和可视化树之间的关系。

设计器视图

DesignerView 类有一个可在 XAML 中使用的空构造函数。

请参见

通过