属性网格扩展性

项目
06/08/2023

可以自定义在设计器中选择给定活动时显示的属性网格，从而创建丰富的编辑体验。 PropertyGridExtensibility 示例完成方式。

演示

工作流设计器属性网格的扩展性。

讨论 (Discussion)

若要扩展属性网格，开发人员可以选择自定义属性网格编辑器的内联外观或提供一个为更高级的编辑图面显示的对话框。此示例中演示了两类不同的编辑器；即内联编辑器和对话框编辑器。

内联编辑器

内联编辑器示例将演示如下内容：

创建一个从 PropertyValueEditor 派生的类型。
在构造函数中，使用 WPF Windows Presentation Foundation (WPF) 数据模板设置 InlineEditorTemplate 值。虽然可以将其绑定到 XAML 模板，但在此示例中，代码用于初始化数据绑定。

数据模板具有在属性网格中呈现的项的 PropertyValue 的数据上下文。请注意，在下面的代码（此代码来自 CustomInlineEditor.cs）中，稍后会将此上下文绑定到 Value 属性。

FrameworkElementFactory stack = new FrameworkElementFactory(typeof(StackPanel));
FrameworkElementFactory slider = new FrameworkElementFactory(typeof(Slider));
Binding sliderBinding = new Binding("Value");
sliderBinding.Mode = BindingMode.TwoWay;
slider.SetValue(Slider.MinimumProperty, 0.0);
slider.SetValue(Slider.MaximumProperty, 100.0);
slider.SetValue(Slider.ValueProperty, sliderBinding);
stack.AppendChild(slider);

由于活动和设计器位于同一个程序集中，因此将在活动自身的静态构造函数中完成对活动设计器特性的注册，如 SimpleCodeActivity.cs 中的以下示例所示。

static SimpleCodeActivity()
{
    AttributeTableBuilder builder = new AttributeTableBuilder();
    builder.AddCustomAttributes(typeof(SimpleCodeActivity), "RepeatCount", new EditorAttribute(typeof(CustomInlineEditor), typeof(PropertyValueEditor)));
    builder.AddCustomAttributes(typeof(SimpleCodeActivity), "FileName", new EditorAttribute(typeof(FilePickerEditor), typeof(DialogPropertyValueEditor)));
    MetadataStore.AddAttributeTable(builder.CreateTable());
}

对话框编辑器

对话框编辑器示例将演示如下内容：

创建一个从 DialogPropertyValueEditor 派生的类型。
在构造函数中，使用 WPF 数据模板设置 InlineEditorTemplate 值。可以在 XAML 中创建该值，但在此示例中，将在代码中创建它。

数据模板具有在属性网格中呈现的项的 PropertyValue 的数据上下文。在下面的代码中，稍后会将其绑定到 Value 属性。此外，包含 EditModeSwitchButton 以提供引发 FilePickerEditor.cs 中的对话框的按钮也很重要。

this.InlineEditorTemplate = new DataTemplate();

FrameworkElementFactory stack = new FrameworkElementFactory(typeof(StackPanel));
stack.SetValue(StackPanel.OrientationProperty, Orientation.Horizontal);
FrameworkElementFactory label = new FrameworkElementFactory(typeof(Label));
Binding labelBinding = new Binding("Value");
label.SetValue(Label.ContentProperty, labelBinding);
label.SetValue(Label.MaxWidthProperty, 90.0);

stack.AppendChild(label);

FrameworkElementFactory editModeSwitch = new FrameworkElementFactory(typeof(EditModeSwitchButton));

editModeSwitch.SetValue(EditModeSwitchButton.TargetEditModeProperty, PropertyContainerEditMode.Dialog);

stack.AppendChild(editModeSwitch);

this.InlineEditorTemplate.VisualTree = stack;

重写设计器类型中的 ShowDialog 方法以处理对话框的显示。在此示例中，显示了基本 FileDialog。

public override void ShowDialog(PropertyValue propertyValue, IInputElement commandSource)
{
    Microsoft.Win32.OpenFileDialog ofd = new Microsoft.Win32.OpenFileDialog();
    if (ofd.ShowDialog() == true)
    {
        propertyValue.Value = ofd.FileName;
    }
}