デザイナーのホスト変更

[アーティクル]
05/10/2023

デザイナーのホスト変更は、カスタムアプリケーション内でワークフローデザインキャンバスをホストすることを示す一般的なシナリオです。多くのユーザーにとって、使い慣れたホストアプリケーションは Visual Studio ですが、アプリケーションでワークフローデザイナーを表示すると役立つ場合があるシナリオも数多くあります。

監視アプリケーション (エンドユーザーがプロセス、およびプロセスに関するランタイムデータ (現在アクティブな状態、実行時間の集計データ、ワークフローのインスタンスに関するその他の情報など) を表示できるようにします)。
ユーザーが限られたアクティビティセットを使用してプロセスをカスタマイズできるようにするアプリケーション。

このような種類のアプリケーションをサポートするために、ワークフローデザイナーが .NET Framework に付属しており、WPF アプリケーション内でホストするか、適切な WPF ホストコードを使用して WinForms アプリケーション内でホストすることができます。 DesignerRehosting サンプルでは次を示します。

WF デザイナーのホスト変更方法。
再ホストされたツールボックスおよびプロパティグリッドの使用方法。

デザイナーのホスト変更

このサンプルでは、次のグリッドレイアウトのような、デザイナーを含む WPF レイアウトを作成する方法を示します (スペースを考慮してツールボックスコードは省略しています)。デザイナーおよびプロパティグリッドを含む罫線の名前に注意してください。

<Grid>
    <Grid.ColumnDefinitions>
        <ColumnDefinition Width="2*"/>
        <ColumnDefinition Width="7*"/>
        <ColumnDefinition Width="3*"/>
    </Grid.ColumnDefinitions>
    <Border Grid.Column="0">
        <sapt:ToolboxControl>...</sapt:ToolboxControl>
    </Border>
    <Border Grid.Column="1" Name="DesignerBorder"/>
    <Border Grid.Column="2" Name="PropertyBorder"/>
</Grid>

次に、このサンプルではデザイナーを作成し、そのプライマリ View および PropertyInspectorView をユーザーインターフェイスの適切なコンテナーに関連付けます。次の例に示すいくつかのコード行について説明します。 Register 呼び出しは、.NET Framework に付属しているアクティビティの既定のアクティビティデザイナーを関連付けるために必要です。 Load は、編集する WF 項目を渡すために呼び出されます。最後に、View (プライマリキャンバス) および PropertyInspectorView (プロパティグリッド) がユーザーインターフェイス画面に配置されます。

protected override void OnInitialized(EventArgs e)
{
   base.OnInitialized(e);
   // register metadata
   (new DesignerMetadata()).Register();

   // create the workflow designer
   WorkflowDesigner wd = new WorkflowDesigner();
   wd.Load(new Sequence());
   DesignerBorder.Child = wd.View;
   PropertyBorder.Child = wd.PropertyInspectorView;
}

再ホストされたツールボックスの使用

このサンプルでは、XAML で宣言によって再ホストされたツールボックスコントロールを使用します。コードで型を ToolboxItemWrapper コンストラクターに渡すことができることに注意してください。

<!-- Copyright (c) Microsoft Corporation. All rights reserved-->
<Window x:Class="Microsoft.Samples.DesignerRehosting.RehostingWfDesigner"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:sapt="clr-namespace:System.Activities.Presentation.Toolbox;assembly=System.Activities.Presentation"
        xmlns:sys="clr-namespace:System;assembly=mscorlib"
        Title="Window1" Height="600" Width="900">
    <Window.Resources>
        <sys:String x:Key="AssemblyName">System.Activities, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35</sys:String>
    </Window.Resources>
    <Grid>
        <Grid.ColumnDefinitions>
            <ColumnDefinition Width="2*"/>
            <ColumnDefinition Width="7*"/>
            <ColumnDefinition Width="3*"/>
        </Grid.ColumnDefinitions>
        <Border Grid.Column="0">
            <sapt:ToolboxControl>
                <sapt:ToolboxCategory CategoryName="Basic">
                    <sapt:ToolboxItemWrapper AssemblyName="{StaticResource AssemblyName}" >
                        <sapt:ToolboxItemWrapper.ToolName>
                            System.Activities.Statements.Sequence
                        </sapt:ToolboxItemWrapper.ToolName>
                       </sapt:ToolboxItemWrapper>
                    <sapt:ToolboxItemWrapper  AssemblyName="{StaticResource AssemblyName}">
                        <sapt:ToolboxItemWrapper.ToolName>
                            System.Activities.Statements.WriteLine
                        </sapt:ToolboxItemWrapper.ToolName>

                    </sapt:ToolboxItemWrapper>
                    <sapt:ToolboxItemWrapper  AssemblyName="{StaticResource AssemblyName}">
                        <sapt:ToolboxItemWrapper.ToolName>
                            System.Activities.Statements.If
                        </sapt:ToolboxItemWrapper.ToolName>

                    </sapt:ToolboxItemWrapper>
                    <sapt:ToolboxItemWrapper  AssemblyName="{StaticResource AssemblyName}">
                        <sapt:ToolboxItemWrapper.ToolName>
                            System.Activities.Statements.While
                        </sapt:ToolboxItemWrapper.ToolName>

                    </sapt:ToolboxItemWrapper>
                </sapt:ToolboxCategory>
            </sapt:ToolboxControl>
        </Border>
        <Border Grid.Column="1" Name="DesignerBorder"/>
        <Border Grid.Column="2" Name="PropertyBorder"/>
    </Grid>
</Window>

サンプルの使用

Visual Studio で DesignerRehosting.sln ソリューションを開きます。
F5 キーを押してアプリケーションをコンパイルし、実行します。
WPF アプリケーションが再ホストされたデザイナーと共に起動します。

次の方法で共有

デザイナーのホスト変更

デザイナーのホスト変更

再ホストされたツールボックスの使用

サンプルの使用

その他のリソース