DesignerActionServiceとは何？わかりやすく解説 Weblio辞書

索引トップ用語の索引ランキング

DesignerActionService イベント

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

参照

その他の技術情報

Windows フォームのデザイナコマンドと DesignerAction オブジェクトモデル

DesignerActionService クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.ComponentModel.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Class DesignerActionService
    Implements IDisposable

Visual Basic (使用法)

Dim instance As DesignerActionService

public class DesignerActionService : IDisposable

C++

public ref class DesignerActionService : IDisposable

public class DesignerActionService implements
 IDisposable

JScript

public class DesignerActionService implements
 IDisposable

解説

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

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

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

メモ
DesignerActionService は、実際にはプッシュモデルとプルモデルの背後にあるドライビングサービスです。ただし、プルモデルでは暗黙的に動作します。

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

Contains メソッドは、DesignerActionService が特定のコンポーネントを現在管理しているかどうかを判断します。
GetComponentActions メソッドは、項目のリストの列挙体をサポートします。

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

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

メモ

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

重要 :
Add、Remove、Contains、および Clear の各メソッドが考慮または影響するのは、プッシュモデルの項目だけです。

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

コンポーネントのデザイン時のショートカットメニューとパネルで、複数の同じパネル項目を使用することが望ましい場合が多いため、DesignerActionItem オブジェクトとデザイナ動詞には、非常に高い相互運用性があります。

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

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

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

継承階層

System.Object
System.ComponentModel.Design.DesignerActionService
System.Web.UI.Design.WebFormsDesignerActionService

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DesignerActionService メンバ
System.ComponentModel.Design 名前空間
DesignerActionListCollection クラス
ComponentDesigner クラス
DesignerActionItem クラス
DesignerActionUIService
その他の技術情報
Windows フォームのデザイナコマンドと DesignerAction オブジェクトモデル

DesignerActionService コンストラクタ

メモ : このコンストラクタは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.ComponentModel.Design
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    serviceProvider As IServiceProvider _
)

Visual Basic (使用法)

Dim serviceProvider As IServiceProvider

Dim instance As New DesignerActionService(serviceProvider)

public DesignerActionService (
    IServiceProvider serviceProvider
)

C++

public:
DesignerActionService (
    IServiceProvider^ serviceProvider
)

public DesignerActionService (
    IServiceProvider serviceProvider
)

JScript

public function DesignerActionService (
    serviceProvider : IServiceProvider
)

パラメータ

serviceProvider: 現在のデザイン時環境のサービスプロバイダ。

解説

サービスプロバイダは、選択項目とコンポーネントの変更を監視するために必要です。サービスプロバイダは、IDesignerHost 型と IComponentChangeService 型をサポートします。DesignerActionService クラスでは、内部テーブルを使用して、コンポーネントおよび関連付けられている DesignerActionList のスマートタグを管理します。

通常、コンポーネント開発者は、このクラスのインスタンスを作成する必要はありません。代わりに、Component.GetService メソッドを呼び出すことによって、既存のインスタンスを取得できます。

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DesignerActionService クラス
DesignerActionService メンバ
System.ComponentModel.Design 名前空間
Dispose
IDesignerHost
IComponentChangeService
Component.GetService
その他の技術情報
Windows フォームのデザイナコマンドと DesignerAction オブジェクトモデル

DesignerActionService メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Add	オーバーロードされます。管理されているスマートタグの現在のコレクションに、1 つ以上の DesignerActionList オブジェクトを追加します。
	Clear	すべてのコンポーネントを管理対象から外し、プッシュモデルのすべてのスマートタグリストを消去します。
	Contains	現在のスマートタグサービスが、指定したコンポーネントのアクションリストを管理しているかどうかを判断します。
	Dispose	オーバーロードされます。 DesignerActionService によって使用されているリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetComponentActions	オーバーロードされます。コンポーネントに関連付けられているスマートタグ項目リストのコレクションを返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Remove	オーバーロードされます。 1 つ以上のコンポーネントから、1 つ以上のスマートタグリストの関連付けを解除します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Dispose	オーバーロードされます。 DesignerActionService によって使用されているリソースを解放します。
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetComponentDesignerActions	コンポーネントに関連付けられているプルモデルのスマートタグを取得します。
	GetComponentServiceActions	コンポーネントに関連付けられているプッシュモデルのスマートタグを取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

その他の技術情報

Windows フォームのデザイナコマンドと DesignerAction オブジェクトモデル

DesignerActionService メンバ

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

DesignerActionService データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

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

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Add	オーバーロードされます。管理されているスマートタグの現在のコレクションに、1 つ以上の DesignerActionList オブジェクトを追加します。
	Clear	すべてのコンポーネントを管理対象から外し、プッシュモデルのすべてのスマートタグリストを消去します。
	Contains	現在のスマートタグサービスが、指定したコンポーネントのアクションリストを管理しているかどうかを判断します。
	Dispose	オーバーロードされます。 DesignerActionService によって使用されているリソースを解放します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetComponentActions	オーバーロードされます。コンポーネントに関連付けられているスマートタグ項目リストのコレクションを返します。
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Remove	オーバーロードされます。 1 つ以上のコンポーネントから、1 つ以上のスマートタグリストの関連付けを解除します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Dispose	オーバーロードされます。 DesignerActionService によって使用されているリソースを解放します。
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetComponentDesignerActions	コンポーネントに関連付けられているプルモデルのスマートタグを取得します。
	GetComponentServiceActions	コンポーネントに関連付けられているプッシュモデルのスマートタグを取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)