DesignerActionService DesignerActionService DesignerActionService DesignerActionService Class

定義

コンポーネントの DesignerActionItem オブジェクトのコレクションを管理するデザイン時サービスを確立します。Establishes a design-time service that manages the collection of DesignerActionItem objects for components.

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

注釈

クラスは、デザイン時にフォーム上にDesignerActionItem存在するコンポーネントの各インスタンスについて、オブジェクトのコレクションを管理します。 DesignerActionServiceThe DesignerActionService class is responsible for managing the collection of DesignerActionItem objects for each instance of a component that exists on a form at design time. このクラスは、項目作成の直接プッシュモデルを有効にします。これは、主にデザイン時ツールの開発者が使用することを目的としていますが、コンポーネントおよびカスタムコントロールの開発者が使用することもできます。This class enables a direct push model of item creation, and is primarily intended for use by design-time tool developers, although it can also be used by component and custom control developers.

デザイン時ツールの開発者は、コンポーネントに対して表示する項目の一覧を決定し、この一覧がいつ変更されるかを判断する必要があります。Design-time tool developers will need to determine the list of items to display for a component and determine when this list changes. また、スマートタグパネルオブジェクトと連携して動作するアドインを作成することもできます。They may also create add-ins that operate in conjunction with smart tag panel objects.

高度なコンポーネントの開発者は、コンポーネントに関連付けられている項目を動的に制御し、標準のプルモデルを置換または補完することが必要になる場合があります。Advanced component developers may need to dynamically control the items associated with a component, thus replacing or supplementing the standard pull model. たとえば、パネルコマンドは、使用のコンテキストと、コンポーネントのデザイン時の状態に応じて変更できます。For example, panel commands can be altered depending on the context of their use and the design-time state of the component.

注意

DesignerActionService 、実際にはプッシュモデルとプルモデルの両方を支える運転サービスですが、後者の場合は暗黙的に動作します。The DesignerActionService is actually the driving service behind both the push and pull models; however, in the latter case it operates implicitly.

DesignerActionServiceは、次のメソッドとイベントを含む、各コンポーネントの項目にアクセスして操作するための簡単なインターフェイスを提供します。DesignerActionService provides a straightforward interface for accessing and manipulating the items for each component, including the following methods and events:

  • メソッドは、が特定DesignerActionServiceのコンポーネントを現在管理しているかどうかを判断します。 ContainsThe Contains method determines whether the DesignerActionService is currently managing a particular component.

  • メソッドGetComponentActionsは、項目のリストの列挙をサポートします。The GetComponentActions method supports the enumeration of the lists of items.

  • メソッドを使用するとDesignerActionListDesignerActionListCollectionコンポーネントインスタンスの既存の項目のセットにまたはを追加できます。 AddThe Add method allows adding a DesignerActionList or DesignerActionListCollection to the set of existing items for a component instance. これに対してRemove 、メソッドは、コンポーネントに関連付けられている1つまたはすべての項目リストを削除します。In contrast, the Remove method removes one or all of the item lists associated with a component.

    注意

    メソッドAddは、パネル項目をコンポーネントに関連付ける直接プッシュモデルを表します。The Add method represents the direct push model of associating panel items with a component. これに対し、プルモデルでは、そのActionListsコンポーネントのデザイナークラスのプロパティのオーバーライドに依存しています。In contrast, the pull model relies on overriding the ActionLists property of the designer class for that component. デザイン環境は、デザインサーフェイスにコンポーネントが作成されDesignerActionServiceたときに、これらの項目を現在のに追加する役割を担います。The design environment is responsible for adding these items into the current DesignerActionService when a component is created on the design surface.

    重要

    、、 Remove Add 、およびClearの各メソッドは、プッシュモデルの項目のみを考慮または影響を与えます。 ContainsThe Add, Remove, Contains, and Clear methods only consider or affect push-model items.

  • イベントDesignerActionListsChangedは、コンポーネントの項目のコレクションが変更されたことを示します。The DesignerActionListsChanged event indicates when the collection of items changes for a component.

コンポーネントのデザイン時ショートカットメニューとそのパネルの両方で同じパネル項目の一部を使用することをお勧めします。オブジェクトとデザイナー動詞の間DesignerActionItemには、多くの相互運用性があります。Because it is often desirable to use some of the same panel items in both the component's design-time shortcut menu and its panel, a large degree of interoperability exists between DesignerActionItem objects and designer verbs.

コンポーネントデザイナーが明示的にをDesignerActionList指定していない場合 (つまり、オーバーライドActionListsされたプロパティが含まれていない場合)、既存のデザイナー動詞からリストが作成されます。If a component designer does not explicitly specify a DesignerActionList (that is, it does not contain an overridden ActionLists property), then a list will be created from existing designer verbs. これらの動詞は、 Verbsプロパティによって指定されます。These verbs are specified by the Verbs property. この場合、動詞項目パネルエントリのコレクションを格納するために、内部動詞リストクラスが使用されます。In this case, an internal verb list class is used to contain the collection of verb item panel entries.

DesignerActionMethodItemパネルエントリとデザイン時ショートカットメニューエントリの両方として使用する場合は、項目のコンストラクターでincludeAsDesignerVerbパラメーターを設定できます。If you want a DesignerActionMethodItem to be used both as a panel entry and a design-time shortcut menu entry, then you can set the includeAsDesignerVerb parameter in the item's constructor.

デザイナーのDesignerActionUIService表示を制御するには、を使用します。ActionListsUse the DesignerActionUIService to control the display of your designer's ActionLists.

コンストラクター

DesignerActionService(IServiceProvider) DesignerActionService(IServiceProvider) DesignerActionService(IServiceProvider) DesignerActionService(IServiceProvider)

DesignerActionService クラスの新しいインスタンスを初期化します。Initializes a new instance of the DesignerActionService class.

メソッド

Add(IComponent, DesignerActionList) Add(IComponent, DesignerActionList) Add(IComponent, DesignerActionList) Add(IComponent, DesignerActionList)

管理されているスマート タグの現在のコレクションに、DesignerActionList を追加します。Adds a DesignerActionList to the current collection of managed smart tags.

Add(IComponent, DesignerActionListCollection) Add(IComponent, DesignerActionListCollection) Add(IComponent, DesignerActionListCollection) Add(IComponent, DesignerActionListCollection)

管理されているスマート タグの現在のコレクションに、DesignerActionListCollection を追加します。Adds a DesignerActionListCollection to the current collection of managed smart tags.

Clear() Clear() Clear() Clear()

すべてのコンポーネントを管理対象から外し、プッシュ モデルのすべてのスマート タグ リストを消去します。Releases all components from management and clears all push-model smart tag lists.

Contains(IComponent) Contains(IComponent) Contains(IComponent) Contains(IComponent)

現在のスマート タグ サービスが、指定したコンポーネントのアクション リストを管理しているかどうかを判断します。Determines whether the current smart tag service manages the action lists for the specified component.

Dispose() Dispose() Dispose() Dispose()

DesignerActionService クラスによって使用されているすべてのリソースを解放します。Releases all resources used by the DesignerActionService class.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

DesignerActionService によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the DesignerActionService and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetComponentActions(IComponent) GetComponentActions(IComponent) GetComponentActions(IComponent) GetComponentActions(IComponent)

コンポーネントに関連付けられているスマート タグ項目リストのコレクションを返します。Returns the collection of smart tag item lists associated with a component.

GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType)

コンポーネントに関連付けられている、指定した型のスマート タグ項目リストのコレクションを返します。Returns the collection of smart tag item lists of the specified type associated with a component.

GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType) GetComponentActions(IComponent, ComponentActionsType)
GetComponentDesignerActions(IComponent, DesignerActionListCollection) GetComponentDesignerActions(IComponent, DesignerActionListCollection) GetComponentDesignerActions(IComponent, DesignerActionListCollection) GetComponentDesignerActions(IComponent, DesignerActionListCollection)

コンポーネントに関連付けられているプル モデルのスマート タグを取得します。Retrieves the pull-model smart tags associated with a component.

GetComponentServiceActions(IComponent, DesignerActionListCollection) GetComponentServiceActions(IComponent, DesignerActionListCollection) GetComponentServiceActions(IComponent, DesignerActionListCollection) GetComponentServiceActions(IComponent, DesignerActionListCollection)

コンポーネントに関連付けられているプッシュ モデルのスマート タグを取得します。Retrieves the push-model smart tags associated with a component.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(DesignerActionList) Remove(DesignerActionList) Remove(DesignerActionList) Remove(DesignerActionList)

現在のサービスによって管理されているすべてのコンポーネントから、指定したスマート タグ リストを削除します。Removes the specified smart tag list from all components managed by the current service.

Remove(IComponent) Remove(IComponent) Remove(IComponent) Remove(IComponent)

指定したコンポーネントに関連付けられているすべてのスマート タグ リストを削除します。Removes all the smart tag lists associated with the specified component.

Remove(IComponent, DesignerActionList) Remove(IComponent, DesignerActionList) Remove(IComponent, DesignerActionList) Remove(IComponent, DesignerActionList)

指定したコンポーネントから、指定したスマート タグ リストを削除します。Removes the specified smart tag list from the specified component.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)

イベント

DesignerActionListsChanged DesignerActionListsChanged DesignerActionListsChanged DesignerActionListsChanged

コンポーネントの DesignerActionList が削除または追加されたときに発生します。Occurs when a DesignerActionList is removed or added for any component.

適用対象

こちらもご覧ください