Infragistics コマンディングについて

コマンディングの概念

ルーティングコマンドは、動作が処理される方法を拡張する、WPF で利用可能な機能です。後で待ち行列に入れて起動することができるアクションのリクエストをカプセル化するためにオブジェクトが使用されるコマンドデザインパターンに従います。オブジェクト、特にコマンドはアクションの動作とソースを実際的なロジックと分離するために使用されます。これは、各ターゲットオブジェクト固有のコマンドの実際的な実行に伴い、ひとつ以上のソースがサポートする任意のオブジェクトでコマンドを呼び出すことを意味します。たとえば、Paste コマンドの場合、このコマンドをサポートする任意のアプリケーションがこのコマンドを使用できます。つまりスプレッドシートアプリケーション、テキストエディターまたは画像編集アプリケーションですが、貼り付け操作の実際のロジックは各アプリケーション固有です。

Infragistics は WPF にあるコマンドの基本的概念に従うコマンドフレームワークを提供しています。Infragistics コマンディングシステムは以下で構成されます:

ソース - コマンドを呼び出すオブジェクト
ターゲット - コマンドが実行するオブジェクト
コマンド - アクション

ソースが生じるイベントをセットアップするときにコマンドが実行します。

ターゲットを見つける

コマンドのターゲットは ICommandTarget インターフェイスを実装しコマンドをサポートするオブジェクトです。イベントが発生する時、コマンドフレームワークはコマンドのターゲットを解決しようとします。これが生じる基本的な方法は 3 通りあります。

CommandSource のターゲットプロパティは直接的に設定されます。
CommandSource は添付コマンドをサポートするすべてのグローバルに登録された ICommandTarget オブジェクトを調べます。コマンドソースには TargetName プロパティがあり、グローバルに登録されたターゲット名を指定してコマンドを実行することができます。
CommandSource は添付コマンドをサポートするすべてのグローバルに登録された ICommandTarget オブジェクトを調べます。コマンドソースには TargetName プロパティがあり、グローバルに登録されたターゲット名を指定してコマンドを実行することができます。ターゲット名を設定しない場合、コマンドはそのコマンドをサポートするすべてのグローバルに登録された ICommandTarget オブジェクトで実行します。
コマンドをサポートするターゲットが見つけられるまでコマンドソースから開始して親エレメントに至るまで視覚ツリーはトラバースします。

コード例

xamGrid コントロールは使用できるさまざまなコマンドを公開します。このようなコマンドのひとつがページングのための NextPage コマンドです。コマンドを実行するには、xamGridPagingCommandSource オブジェクトなどのコマンドソースを使用して、オブジェクトの EventName プロパティと CommandType プロパティをそれぞれ使用してイベントとコマンドタイプを設定します。視覚ツリーのターゲットでコマンドが実行されます。以下の XAML では、ボタンがクリックされると NextPage コマンドが実行します。コマンドをサポートする視覚ツリーの最初のオブジェクトであるため、コマンドは PagerCellControl オブジェクトで実行します。

XAML の場合:

xmlns:ig="http://schemas.infragistics.com/xaml"
xmlns:igPrim="http://schemas.infragistics.com/xaml/primitives"

XAML の場合:

<Style x:Name="CustomPager1" TargetType="gridParts:PagerCellControl">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="igPrim:PagerCellControl">
                <Button x:Name="NextPageButton" Content="Next">
                <!-- 使用するコマンドを指定します。コマンドはボタン内にあるため、EventName プロパティはボタンのイベントを参照します。-->
                    <ig:Commanding.Command>
                        <ig:XamGridPagingCommandSource EventName="Click" CommandType="NextPage"/>
                    </ig:Commanding.Command>
                </Button>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

以下のコードは、xamSpellChecker で正しいターゲットを見つけるためにコマンドソースの TargetName プロパティを使用する方法を示します。

XAML の場合:

<ig:XamSpellChecker x:Name="spellChecker">
    <ig:XamSpellChecker.SpellCheckTargets>
        <Binding ElementName="Note" Path="Text" Mode="TwoWay"/>
    </ig:XamSpellChecker.SpellCheckTargets>
</ig:XamSpellChecker>
<Button Content="Spell Check" >
    <ig:Commanding.Command>
        <ig:XamSpellCheckerCommandSource CommandType="SpellCheck" TargetName="spellChecker" EventName="Click"/>
    </ig:Commanding.Command>
</Button>

WPF | ヘルプ トピック

Infragistics コマンディングについて

WPF | ヘルプトピック