DesignerActionService クラス

  • リファレンス

定義

名前空間:
System.ComponentModel.Design
アセンブリ:
System.Design.dll
アセンブリ:
System.Windows.Forms.Design.dll

コンポーネントの DesignerActionItem オブジェクトのコレクションを管理するデザイン時サービスを確立します。

public ref class DesignerActionService : IDisposable
public class DesignerActionService : IDisposable
type DesignerActionService = class
    interface IDisposable
Public Class DesignerActionService
Implements IDisposable
継承
Object
DesignerActionService
派生
実装
IDisposable

注釈

クラスは DesignerActionService 、デザイン時にフォーム上に存在するコンポーネントの各インスタンスのオブジェクトのコレクション DesignerActionItem を管理する役割を担います。 このクラスは、アイテム作成の直接プッシュ モデルを有効にし、主にデザイン時のツール開発者が使用することを目的としていますが、コンポーネントおよびカスタム コントロールの開発者も使用できます。

デザイン時ツールの開発者は、コンポーネントに対して表示する項目の一覧を決定し、このリストがいつ変更されたのかを判断する必要があります。 また、スマート タグ パネル オブジェクトと組み合わせて動作するアドインを作成することもできます。

高度なコンポーネント開発者は、コンポーネントに関連付けられている項目を動的に制御し、標準のプル モデルを置き換えたり補完したりする必要がある場合があります。 たとえば、パネル コマンドは、使用のコンテキストとコンポーネントのデザイン時の状態に応じて変更できます。

注意

DesignerActionServiceは実際にはプッシュ モデルとプル モデルの両方の背後にある駆動サービスです。ただし、後者の場合は暗黙的に動作します。

DesignerActionService には、次のメソッドやイベントなど、各コンポーネントの項目にアクセスして操作するための簡単なインターフェイスが用意されています。

  • メソッドは Contains 、 が特定の DesignerActionService コンポーネントを現在管理しているかどうかを判断します。

  • メソッドは GetComponentActions 、項目のリストの列挙をサポートします。

  • メソッドを Add 使用すると、 DesignerActionList コンポーネント インスタンスの既存の項目のセットに または DesignerActionListCollection を追加できます。 これに対し、 メソッドは、コンポーネントに Remove 関連付けられている項目リストの 1 つまたはすべてを削除します。

    注意

    メソッドは Add 、パネル項目をコンポーネントに関連付ける直接プッシュ モデルを表します。 これに対し、プル モデルは、そのコンポーネントのデザイナー クラスのプロパティをオーバーライド ActionLists することに依存しています。 デザイン環境では、コンポーネントがデザイン サーフェイスに作成されるときに、これらの項目を現在 DesignerActionService のに追加する必要があります。

    重要

    、Remove、Contains、および Clear の各メソッドはAdd、プッシュ モデル項目のみを考慮または影響します。

  • イベントは DesignerActionListsChanged 、コンポーネントの項目のコレクションが変更されたタイミングを示します。

多くの場合、コンポーネントのデザイン時ショートカット メニューとそのパネルの両方で同じパネル項目の一部を使用することが望ましいため、オブジェクトとデザイナー動詞の間 DesignerActionItem には大きな相互運用性が存在します。

コンポーネント デザイナーが 明示的に を DesignerActionList 指定しない場合 (つまり、オーバーライドされた ActionLists プロパティが含まれていない場合)、既存のデザイナー動詞からリストが作成されます。 これらの動詞は、 プロパティによって Verbs 指定されます。 この場合、動詞項目パネル エントリのコレクションを格納するために、内部動詞リスト クラスが使用されます。

をパネル エントリとデザイン時ショートカット メニュー エントリの両方として使用する DesignerActionMethodItem 場合は、項目のコンストラクターで パラメーターを設定 includeAsDesignerVerb できます。

デザイナーActionListsの DesignerActionUIService の表示を制御するには、 を使用します。

コンストラクター

DesignerActionService(IServiceProvider)

DesignerActionService クラスの新しいインスタンスを初期化します。

メソッド

Add(IComponent, DesignerActionList)

管理されているスマート タグの現在のコレクションに、DesignerActionList を追加します。
Add(IComponent, DesignerActionListCollection)

管理されているスマート タグの現在のコレクションに、DesignerActionListCollection を追加します。
Clear()

すべてのコンポーネントを管理対象から外し、プッシュ モデルのすべてのスマート タグ リストを消去します。
Contains(IComponent)

現在のスマート タグ サービスが、指定したコンポーネントのアクション リストを管理しているかどうかを判断します。
Dispose()

DesignerActionService クラスによって使用されているすべてのリソースを解放します。
Dispose(Boolean)

DesignerActionService によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。

(継承元 Object)
GetComponentActions(IComponent)

コンポーネントに関連付けられているスマート タグ項目リストのコレクションを返します。
GetComponentActions(IComponent, ComponentActionsType)

コンポーネントに関連付けられている、指定した型のスマート タグ項目リストのコレクションを返します。
GetComponentActions(IComponent, ComponentActionsType)

コンポーネントに関連付けられている指定した型のデザイナー アクション 項目リストのコレクションを返します。
GetComponentDesignerActions(IComponent, DesignerActionListCollection)

コンポーネントに関連付けられているプル モデルのスマート タグを取得します。
GetComponentServiceActions(IComponent, DesignerActionListCollection)

コンポーネントに関連付けられているプッシュ モデルのスマート タグを取得します。
GetHashCode()

既定のハッシュ関数として機能します。

(継承元 Object)
GetType()

現在のインスタンスの Type を取得します。

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。

(継承元 Object)
Remove(DesignerActionList)

現在のサービスによって管理されているすべてのコンポーネントから、指定したスマート タグ リストを削除します。
Remove(IComponent)

指定したコンポーネントに関連付けられているすべてのスマート タグ リストを削除します。
Remove(IComponent, DesignerActionList)

指定したコンポーネントから、指定したスマート タグ リストを削除します。
ToString()

現在のオブジェクトを表す文字列を返します。

(継承元 Object)

イベント

DesignerActionListsChanged

コンポーネントの DesignerActionList が削除または追加されたときに発生します。

適用対象

こちらもご覧ください