属性网格扩展性
本主题适用于 Windows Workflow Foundation 4。
开发人员可以自定义属性网格,此网格将在设计器中选择给定活动时显示。执行此操作可获得丰富的编辑体验。此示例演示如何完成此操作。
演示
工作流设计器属性网格的扩展性。
注意: |
---|
您的计算机上可能已安装这些示例。在继续操作之前,请先检查以下(默认)目录:
<安装驱动器>:\WF_WCF_Samples
如果此目录不存在,请转到 .NET Framework 4 的 Windows Communication Foundation (WCF) 和 Windows Workflow Foundation (WF) 示例(可能为英文网页),下载所有 Windows Communication Foundation (WCF) 和 WF 示例。此示例位于以下目录:
<安装驱动器>:\WF_WCF_Samples\WF\Basic\Designer\PropertyGridExtensibility
|
讨论
若要扩展属性网格,开发人员可以选择自定义属性网格编辑器的内联外观或提供一个为更高级的编辑图面显示的对话框。此示例中演示了两类不同的编辑器;即内联编辑器和对话框编辑器。
内联编辑器
内联编辑器示例将演示如下内容:
创建一个从 PropertyValueEditor 派生的类型。
在构造函数中,使用 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; } }
由于活动和设计器位于同一个程序集中,因此将在活动自身的静态构造函数中完成对活动设计器特性的注册,如 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()); }
设置、生成和运行示例
生成解决方案,然后打开 Workflow1.xaml。
将**“SimpleCodeActivity”**从工具箱中拖动到设计器画布上。
单击**“SimpleCodeActivity”**,然后打开包含滑块控件和文件选取控件的属性网格。
注意: |
---|
您的计算机上可能已安装这些示例。在继续操作之前,请先检查以下(默认)目录:
<安装驱动器>:\WF_WCF_Samples
如果此目录不存在,请转到 .NET Framework 4 的 Windows Communication Foundation (WCF) 和 Windows Workflow Foundation (WF) 示例(可能为英文网页),下载所有 Windows Communication Foundation (WCF) 和 WF 示例。此示例位于以下目录:
<安装驱动器>:\WF_WCF_Samples\WF\Basic\Designer\PropertyGridExtensibility
|