自定义复合设计器 — 工作流项演示器

System.Activities.Presentation.WorkflowItemsPresenter 是 WF 设计器编程模型中的一个重要类型,可用于编辑包含元素的集合。 此示例演示如何生成一个呈现此类可编辑集合的活动设计器。

WorkflowItemsPresenter 示例演示:

设置、生成和运行示例

  1. 在 Visual Studio 中打开适用于 C# 或 Visual Basic 的“UsingWorkflowItemsPresenter.sln”示例解决方案。

  2. 生成并运行解决方案。

    会打开一个重新承载的工作流设计器应用程序,可以将活动拖动到画布上。

示例重点

此示例的代码演示了以下内容:

  • 构建的设计器所针对的活动:Parallel

  • 使用 System.Activities.Presentation.WorkflowItemsPresenter 创建自定义活动设计器。 需要指出的一些事项:

    • 请注意,应使用 WPF 数据绑定来绑定到 ModelItem.BranchesModelItemWorkflowElementDesigner 的属性,它引用设计器所用于的基础对象,在此例中为 Parallel

    • WorkflowItemsPresenter.SpacerTemplate 可用于在集合中的各个项之间显示一个可视对象。

    • WorkflowItemsPresenter.ItemsPanel 是一个模板,可用于确定集合中的项的布局。 在此例中,使用水平堆叠面板。

    下面的示例代码演示了此过程。

    <sad:WorkflowItemsPresenter HintText="Drop Activities Here"
                                  Items="{Binding Path=ModelItem.Branches}">
        <sad:WorkflowItemsPresenter.SpacerTemplate>
          <DataTemplate>
            <Ellipse Width="10" Height="10" Fill="Black"/>
          </DataTemplate>
        </sad:WorkflowItemsPresenter.SpacerTemplate>
        <sad:WorkflowItemsPresenter.ItemsPanel>
          <ItemsPanelTemplate>
            <StackPanel Orientation="Horizontal"/>
          </ItemsPanelTemplate>
        </sad:WorkflowItemsPresenter.ItemsPanel>
      </sad:WorkflowItemsPresenter>
    
  • 执行 DesignerAttributeParallel 类型的关联,然后输出报告的特性。

    • 首先,注册所有默认的设计器。

      以下是代码示例。

      // register metadata
      (new DesignerMetadata()).Register();
      RegisterCustomMetadata();
      
      ' register metadata
      Dim metadata = New DesignerMetadata()
      metadata.Register()
      ' register custom metadata
      RegisterCustomMetadata()
      
    • 然后,在 RegisterCustomMetadata 方法中重写此并行处理。

      下面的代码分别使用 C# 和 Visual Basic 演示了此过程。

      void RegisterCustomMetadata()
      {
            AttributeTableBuilder builder = new AttributeTableBuilder();
            builder.AddCustomAttributes(typeof(Parallel), new DesignerAttribute(typeof(CustomParallelDesigner)));
            MetadataStore.AddAttributeTable(builder.CreateTable());
      }
      
      Sub RegisterCustomMetadata()
         Dim builder As New AttributeTableBuilder()
         builder.AddCustomAttributes(GetType(Parallel), New DesignerAttribute(GetType(CustomParallelDesigner)))
         MetadataStore.AddAttributeTable(builder.CreateTable())
      End Sub
      
  • 最后,请注意使用不同的数据模板和触发器来基于 IsRootDesigner 属性选择适当的模板。

    以下是代码示例。

    <sad:ActivityDesigner x:Class="Microsoft.Samples.CustomParallelDesigner"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:sad="clr-namespace:System.Activities.Design;assembly=System.Activities.Design"
        xmlns:sadv="clr-namespace:System.Activities.Design.View;assembly=System.Activities.Design">
      <sad:ActivityDesigner.Resources>
        <DataTemplate x:Key="Expanded">
          <StackPanel>
            <TextBlock>This is the Expanded View</TextBlock>
            <sad:WorkflowItemsPresenter HintText="Drop Activities Here"
                                        Items="{Binding Path=ModelItem.Branches}">
              <sad:WorkflowItemsPresenter.SpacerTemplate>
                <DataTemplate>
                  <Ellipse Width="10" Height="10" Fill="Black"/>
                </DataTemplate>
              </sad:WorkflowItemsPresenter.SpacerTemplate>
              <sad:WorkflowItemsPresenter.ItemsPanel>
                <ItemsPanelTemplate>
                  <StackPanel Orientation="Horizontal"/>
                </ItemsPanelTemplate>
              </sad:WorkflowItemsPresenter.ItemsPanel>
            </sad:WorkflowItemsPresenter>
          </StackPanel>
        </DataTemplate>
        <DataTemplate x:Key="Collapsed">
          <TextBlock>This is the Collapsed View</TextBlock>
        </DataTemplate>
        <Style x:Key="ExpandOrCollapsedStyle" TargetType="{x:Type ContentPresenter}">
          <Setter Property="ContentTemplate" Value="{DynamicResource Collapsed}"/>
          <Style.Triggers>
            <DataTrigger Binding="{Binding Path=IsRootDesigner}" Value="true">
              <Setter Property="ContentTemplate" Value="{DynamicResource Expanded}"/>
            </DataTrigger>
          </Style.Triggers>
        </Style>
      </sad: ActivityDesigner.Resources>
      <Grid>
        <ContentPresenter Style="{DynamicResource ExpandOrCollapsedStyle}" Content="{Binding}"/>
      </Grid>
    </sad: ActivityDesigner>
    

另请参阅