動作サービスの概要

[アーティクル]
02/21/2013

BehaviorService はデザイナーのユーザーインターフェイスを管理します。これにより、マウス関連のイベント、メニューコマンド、OLE ドラッグアンドドロップ操作など、デザイン時のユーザーインターフェイス要素の操作が統一されます。

デザイン時のユーザーインターフェイスの管理

カスタムのデザイン時の操作を作成する際には、ユーザーインターフェイスの管理が重要です。カスタムコントロールにデザイン時の操作を提供するには、カスタムデザイナーを作成します。

デザイナーの開発者は、adorners という名前の独自のユーザーインターフェイスレイヤーを作成します。各レイヤーでは、描画、ドラッグなどの UI 操作用に、独自の Glyph 型を作成します。各 Glyph には、関連付けられている Behavior 型があります。Behavior は、メニューコマンド、マウスの動作、OLE ドラッグアンドドロップ操作など、すべてのユーザー入力のオーバーロードを持つクラスです。また、Behavior オブジェクトを Glyph オブジェクトとは別に追加して、デザイナー全体の一般的なユーザー入力にフックできます。上記の 3 つの機能はいずれも、Behavior 型で実装されます。

[!メモ]

デザイン時アセンブリ System.Design.dll への参照を追加する必要があります。このアセンブリは、.NET Framework 4 Client Profile には含まれていません。System.Design.dll への参照を追加するには、プロジェクトのターゲットフレームワークを .NET Framework 4 に変更する必要があります。

.NET Framework バージョン 1.1 では、OnMouseDragBegin などの一部のイベントは ControlDesigner クラスによって公開されていました。このモデルでは、UI デザイナーのロジックの大部分が EventHandler で実装されます。ユーザーが操作するコントロール上にはいくつかの異なる領域が存在するため、このモデルではサポートのための多数のロジックを記述する必要がありました。

Behavior 型では、このような状況が解決されます。BehaviorService は 2 つの部分から構成されます。それぞれの要素の説明を次の表に示します。

指定項目	Description
Behavior クラスのスタック	各クラスには、メニューコマンド、OLE ドラッグアンドドロップ操作、マウスイベントなどに関連するメソッドがあります。スタックの先頭のクラスがアクティブな Behavior であり、すべてのユーザー入力はこの Behavior を経由します。
Adorner オブジェクトおよび Glyph オブジェクト	Adorner は、デザインサーフェイスとユーザーの間にある非表示のレイヤーです。Adorner には Glyph オブジェクトを含めることができます。このオブジェクトは軽量のレンダリングされたオブジェクトです。Glyph は、動作サービスによるヒットテストを受けることができます。このヒットテストから true が報告される限り、アクティブな Behavior は Behavior オブジェクトであり、Glyph はオプションでこのオブジェクトを公開できます。

Behavior クラスのスタック

各クラスには、メニューコマンド、OLE ドラッグアンドドロップ操作、マウスイベントなどに関連するメソッドがあります。スタックの先頭のクラスがアクティブな Behavior であり、すべてのユーザー入力はこの Behavior を経由します。

Adorner オブジェクトおよび Glyph オブジェクト

Adorner は、デザインサーフェイスとユーザーの間にある非表示のレイヤーです。Adorner には Glyph オブジェクトを含めることができます。このオブジェクトは軽量のレンダリングされたオブジェクトです。Glyph は、動作サービスによるヒットテストを受けることができます。このヒットテストから true が報告される限り、アクティブな Behavior は Behavior オブジェクトであり、Glyph はオプションでこのオブジェクトを公開できます。

Windows フォームデザイナーでは、ドラッグおよびマウスの移動に対してオリジナルの ControlDesigner のオーバーライドが引き続きサポートされていますが、これらのアクションは Behavior オブジェクトとして実装されています。ドラッグハンドルの標準的なセットを持つ単純なコントロールのデザイナー内の要素を次の表に示します。

Behavior の要素	Description
選択 Adorner	Adorner の単一のレイヤーがすべての選択 UI Glyph オブジェクトを処理します。
本体 Glyph	完全に透過的な本体 Glyph がコントロールの先頭にあります。この動作がすべてのマウス操作を処理します。
グラブ Glyph	グラブ Glyph オブジェクトは、コントロールのグラブハンドルを描画します。これらの Behavior オブジェクトがドラッグ操作を制御します。

デザイン時のユーザーインターフェイスの拡張

BehaviorService モデルを使用すると、新機能を既存のユーザーインターフェイス上に簡単にレイヤーとして配置できます。新しい UI は、前に定義した他の Glyph および Behavior オブジェクトとは無関係なままです。たとえば、一部のコントロール上のスマートタグへは、コントロール ( スマートタググリフ ) の右上隅にある Glyph でアクセスします。

スマートタグコードは独自の Adorner レイヤーを作成し、このレイヤーに Glyph オブジェクトを追加します。これにより、スマートタグ Glyph オブジェクトは、選択 Glyph オブジェクトから切り離された状態を維持します。新しい Adorner を Adorners コレクションに追加するのに必要なコードは簡単です。

    behaviorService = (BehaviorService)serviceProvider.GetService(typeof(BehaviorService));
    designerActionAdorner = new Adorner();
    behaviorService.Adorners.Add(designerActionAdorner);
    Glyph dag = new DesignerActionGlyph(/*...*/);
    designerActionAdorner.Glyphs.Add(dag);

Glyph と Behavior

Glyph 型は単純です。複雑な機能が必要な場合は、Glyph から派生した独自のクラスに追加します。

Glyph オブジェクトには Behavior オブジェクトが含まれている場合がありますが、必須ではありません。Behavior オブジェクトのない Glyph には、null を返す Behavior プロパティがあります。

Behavior には、サポートされているユーザーの対応ごとにメソッドがあります。たとえば、基本 Behavior クラスには、ドラッグアンドドロップ操作をサポートする OnDragEnter や OnGiveFeedback などのメソッドがあります。

大部分のメソッドは、イベントが処理されたかどうかを示すブール値を返します。ドラッグイベントには、DragEventArgs パラメーター内に値があります。FindCommand メソッドからメニュー項目を返して、それを個別に追加または削除できます。FindCommand メソッドは DisableAllCommands プロパティと連動して、MenuCommand オブジェクトと動作との対話方法を指定します。

Adorner

Adorner は、Glyph オブジェクトから成るユーザーインターフェイス関連要素と BehaviorService の間のプロキシと見なすことができます。

各 Adorner は有効または無効にできます。有効にされた Adorner オブジェクトのみが BehaviorService からヒットテストおよび描画メッセージを受け取ります。

BehaviorService の BehaviorServiceAdornerCollection に Adorner を追加すると、コレクションは Adorner が BehaviorService をコールバックできるように BehaviorService プロパティを設定します。

Adorner オブジェクトの Invalidate メソッドを呼び出すと、関連付けられている BehaviorService によって Adorner ウィンドウが更新されます。

動作のプッシュ

Behavior オブジェクトを動作スタックに追加するには、Glyph オブジェクトを使用するのが最も簡単な方法です。ただし、他にも方法があります。Glyph オブジェクト自体が動作スタックの Behavior オブジェクトをプッシュできます。また、Behavior オブジェクトを動作スタックに直接プッシュすることもできます。デザインサーフェイス上でグラブハンドルをドラッグする場合について考えます。ドラッグを追跡するロジックを記述する代わりに、Glyph 自体が動作スタックを使用して次のアクションを順に実行します。

Glyph には、マウスをクリックする動作に応答する Behavior が関連付けられています。
マウスボタンが押されると、Glyph は新しい Behavior を動作スタックにプッシュします。この Behavior は、mouse-move イベントおよび mouse-up イベントを処理します。また、すべてのメニューコマンドを無効にして、ドラッグ中にはキーボードショートカットや他のコマンドを実行できないようにします。
マウスボタンを離すと、Behavior は移動の動作を終了し、動作スタックからポップされます。これにより、前の Behavior が自動的に復元されます。

[!メモ]

BehaviorService アーキテクチャは Windows フォームモデルに結び付けられているため、Web フォームなどの他の表示テクノロジはサポートしていません。

参照

その他の技術情報

デザイン時サポートの拡張

次の方法で共有

動作サービスの概要

デザイン時のユーザーインターフェイスの管理

デザイン時のユーザーインターフェイスの拡張

Glyph と Behavior

Adorner

動作のプッシュ

参照

関連項目

その他の技術情報

その他のリソース

次の方法で共有

動作サービスの概要

デザイン時のユーザー インターフェイスの管理

デザイン時のユーザー インターフェイスの拡張

Glyph と Behavior

Adorner

動作のプッシュ

参照

関連項目

その他の技術情報

その他のリソース

デザイン時のユーザーインターフェイスの管理

デザイン時のユーザーインターフェイスの拡張