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
派生
実装

注釈

DesignerActionServiceクラスは、のコレクションを管理する責任を負いますDesignerActionItemデザイン時にフォーム上に存在するコンポーネントの各インスタンスのオブジェクト。The 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:

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

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

  • Addメソッドでは、追加できるように、DesignerActionListまたはDesignerActionListCollection一連のコンポーネント インスタンスの既存の項目にします。The 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.

    重要

    AddRemoveContains、およびClearを検討してくださいまたはプッシュ モデル アイテムに影響を与えるだけのメソッド。The 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のデザイナーの表示を制御するActionListsします。Use 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.

適用対象

こちらもご覧ください