通过

演练：实现内联值编辑器

  • 项目

使用 适用于 Visual Studio 的 WPF 设计器的扩展性模型，可以在设计时，在“属性”窗口中为属性创建自定义值编辑器。 编辑器可以是内联编辑器（允许您在“属性”窗口中直接编辑值），也可以是扩展编辑器（允许您提供用来在“属性”窗口外部编辑属性的其他 UI）。 为了演示如何创建内联编辑器，本演练提供了为控件的 Background 属性创建内联值编辑器的分步过程。

在本演练中，您将执行下列任务：

  • 创建 WPF 自定义控件项目。

  • 创建可用来在“属性”窗口中编辑属性值的内联编辑器。

  • 创建一个继承自 PropertyValueEditor 的类，该类用来将内联编辑器连接到要为其提供自定义编辑的类。

  • 创建一个用来实现 IProvideAttributeTable 接口的类，以注册新的内联编辑器。

  • 在设计时测试内联值编辑器。

系统必备

您需要以下组件来完成本演练：

  • Visual Studio 2010.

创建自定义控件

第一步是为自定义控件创建项目。 该控件是一个带有少量设计时代码的简单按钮，该按钮使用 GetIsInDesignMode 方法来实现设计时行为。

创建自定义控件

  1. 使用 Visual C# 创建一个名为 CustomControlLibrary 的新 WPF 自定义控件库项目。

    CustomControl1 的代码在“代码编辑器”中打开。

  2. 在 CustomControl1 的代码编辑器中，用下面的代码替换 CustomControlLibrary 命名空间中的代码：

    using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

namespace CustomControlLibrary
{
    public class CustomControl1 : Button
    {
        public CustomControl1()
        {
            if (System.ComponentModel.DesignerProperties.GetIsInDesignMode(this))
            {
                Content = "In design mode";
            }
        }
    }
}

  3. 将项目的输出路径设置为“bin\”。

  4. 生成解决方案。

为内联编辑器创建模板

内联编辑器可以用 XAML 数据模板创建。 这将是一个简单的下拉列表，其中显示 Background 属性的颜色选项列表。

为内联编辑器创建模板

  1. 使用 Visual C# 向解决方案中添加一个名为 CustomControlLibrary.Design 的新 WPF 自定义控件库项目。

    CustomControl1 的代码在“代码编辑器”中打开。

  2. 在**“解决方案资源管理器”**中，将 CustomControl1 文件从 CustomControlLibrary.Design 项目中删除。

  3. 添加对以下 WPF 设计器程序集的引用。

    • Microsoft.Windows.Design.Extensibility

    • Microsoft.Windows.Design.Interaction

  4. 添加对 CustomControlLibrary 项目的引用。

  5. 将项目的输出路径设置为“.. \CustomControlLibrary\bin\”。 这样可使控件的程序集与元数据程序集位于同一文件夹中，从而可为设计器启用元数据发现。

  6. 向 CustomControlLibrary.Design 项目中添加一个名为 EditorResources 的新类。

  7. 在 EditorResources 的代码编辑器中，用下面的代码替换自动生成的代码。

    namespace CustomControlLibrary.Design
{
    using System;
    using System.Collections.Generic;
    using System.Text;
    using System.Windows;
    public partial class EditorResources : ResourceDictionary
    {
        public EditorResources()
            : base()
        {
            InitializeComponent();
        }
    }
}

  8. 在**“项目”菜单中，单击“添加资源字典”**。

  9. 将该文件命名为 EditorResources.xaml 并单击**“添加”**。

  10. 在 EditorResources 的 XAML 视图中，用下面的 XAML 替换自动生成的 XAML。

        <ResourceDictionary
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:PropertyEditing="clr-namespace:Microsoft.Windows.Design.PropertyEditing;assembly=Microsoft.Windows.Design.Interaction"
    xmlns:Local="clr-namespace:CustomControlLibrary.Design"
    xmlns:Media="clr-namespace:System.Windows.Media;assembly=PresentationCore"
    xmlns:sys="clr-namespace:System;assembly=mscorlib"
    x:Class="CustomControlLibrary.Design.EditorResources">
    <DataTemplate x:Key="BrushInlineEditorTemplate">
        <Grid>
            <Grid.ColumnDefinitions>
                <ColumnDefinition Width="1*"/>
                <ColumnDefinition Width="Auto"/>
            </Grid.ColumnDefinitions>
            <ComboBox Grid.Column="0" Text="{Binding StringValue}">
                <ComboBoxItem>Red</ComboBoxItem>
                <ComboBoxItem>Blue</ComboBoxItem>
                <ComboBoxItem>Green</ComboBoxItem>
            </ComboBox>
        </Grid>
    </DataTemplate>
</ResourceDictionary>

  11. 生成解决方案。

封装模板并注册内联编辑器

在为内联编辑器创建了模板之后，现在必须创建一个继承自 PropertyValueEditor 的类以便将该模板用作自定义编辑器，而且必须注册新的内联编辑器。

封装并注册内联编辑器

  1. 向 CustomControlLibrary.Design 项目中添加一个名为 BrushInlineEditor 的新类。

  2. 在 BrushInlineEditor 的代码编辑器中，用下面的代码替换自动生成的代码。

    using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows;
using Microsoft.Windows.Design.PropertyEditing;

namespace CustomControlLibrary.Design
{
    public class BrushInlineEditor : PropertyValueEditor
    {
        private EditorResources res = new EditorResources();

        public BrushInlineEditor()
        {
            this.InlineEditorTemplate = res["BrushInlineEditorTemplate"] as DataTemplate;
        }
    }
}

  3. 向 CustomControlLibrary.Design 项目中添加一个名为 Metadata 的新类。

  4. 在 Metadata 的代码编辑器中，用下面的代码替换自动生成的代码。

    using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Windows.Design.Metadata;
using System.ComponentModel;
using Microsoft.Windows.Design.PropertyEditing;
using System.Windows.Media;
using System.Windows.Controls;
using System.Windows;
using CustomControlLibrary;

// The ProvideMetadata assembly-level attribute indicates to designers
// that this assembly contains a class that provides an attribute table. 
[assembly: ProvideMetadata(typeof(CustomControlLibrary.Design.Metadata))]

namespace CustomControlLibrary.Design
{
    // Container for any general design-time metadata to initialize.
    // Designers look for a type in the design-time assembly that 
    // implements IProvideAttributeTable. If found, designers instantiate 
    // this class and access its AttributeTable property automatically.
    internal class Metadata : IProvideAttributeTable
    {
        // Accessed by the designer to register any design-time metadata.
        public AttributeTable AttributeTable
        {
            get
            {
                AttributeTableBuilder builder = new AttributeTableBuilder();
                builder.AddCustomAttributes
                    (typeof(CustomControl1),
                    "Background",
                    PropertyValueEditor.CreateEditorAttribute(
                        typeof(BrushInlineEditor)));

                return builder.CreateTable();
            }
        }
    }
}

  5. 生成解决方案。

测试内联值编辑器

内联值编辑器现在已经完成，可以开始使用了。 剩下的工作就是对其进行测试。 若要测试内联编辑器，需要向您的项目中添加一个 WPF 应用程序，向该 WPF 应用程序中添加自定义控件，并查看操作中的内联编辑器。

测试内联值编辑器

  1. 使用 Visual C# 向解决方案中添加一个名为 DemoApplication 的新 WPF 应用程序项目。

    MainWindow.xaml 将在 WPF 设计器中打开。

  2. 添加对 CustomControlLibrary 项目的引用。

  3. 在 MainWindow.xaml 的 XAML 视图中，用下面的 XAML 替换自动生成的 XAML。 此 XAML 将添加对 CustomControlLibrary 命名空间的引用并添加 CustomControl1 自定义控件。 该按钮将出现在设计视图中而且将具有红色背景，这表明该控件处于设计模式下。 如果该按钮未出现，则可能需要单击设计器顶部的信息栏以重新加载视图。

        <Window x:Class="DemoApplication.MainWindow"
    xmlns="https://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="https://schemas.microsoft.com/winfx/2006/xaml"
    Title="Window1" Height="300" Width="300" xmlns:my="clr-namespace:CustomControlLibrary;assembly=CustomControlLibrary">
    <Grid>
        <my:CustomControl1 Margin="30,30,30,30" Name="customControl11"></my:CustomControl1>
    </Grid>
</Window>

  4. 在设计视图中选择该控件。

  5. 在**“属性”窗口中，单击“Background”**属性旁边的下拉按钮。 将显示一个小型的、表示新内联编辑器的颜色选项列表（而不是默认的颜色列表）。 颜色选项包括“红色”、“蓝色”和“绿色”。

  6. 从下拉列表中选择一种颜色。 自定义控件的背景色将更改为所选颜色。

后续步骤

对于更复杂的属性编辑器，请参见演练：实现颜色编辑器，该主题演示如何创建扩展编辑器。

请参见

任务

演练：实现颜色编辑器

如何：创建值编辑器

其他资源

创建自定义编辑器

WPF 设计器扩展性