Establishes a design-time service that manages the collection of DesignerActionItem objects for components.
Assembly: System.Design (in System.Design.dll)
Thetype exposes the following members.
|Add(IComponent, DesignerActionList)||Adds a DesignerActionList to the current collection of managed smart tags.|
|Add(IComponent, DesignerActionListCollection)||Adds a DesignerActionListCollection to the current collection of managed smart tags.|
|Clear||Releases all components from management and clears all push-model smart tag lists.|
|Contains||Determines whether the current smart tag service manages the action lists for the specified component.|
|Dispose()||Releases all resources used by the class.|
|Dispose(Boolean)||Releases the unmanaged resources used by the and optionally releases the managed resources.|
|Equals(Object)||Determines whether the specified object is equal to the current object. (Inherited from Object.)|
|Finalize||Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)|
|GetComponentActions(IComponent)||Returns the collection of smart tag item lists associated with a component.|
|GetComponentActions(IComponent, ComponentActionsType)||Returns the collection of smart tag item lists of the specified type associated with a component.|
|GetComponentDesignerActions||Retrieves the pull-model smart tags associated with a component.|
|GetComponentServiceActions||Retrieves the push-model smart tags associated with a component.|
|GetHashCode||Serves as the default hash function. (Inherited from Object.)|
|GetType||Gets the Type of the current instance. (Inherited from Object.)|
|MemberwiseClone||Creates a shallow copy of the current Object. (Inherited from Object.)|
|Remove(DesignerActionList)||Removes the specified smart tag list from all components managed by the current service.|
|Remove(IComponent)||Removes all the smart tag lists associated with the specified component.|
|Remove(IComponent, DesignerActionList)||Removes the specified smart tag list from the specified component.|
|ToString||Returns a string that represents the current object. (Inherited from Object.)|
The 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.
The is actually the driving service behind both the push and pull models; however, in the latter case it operates implicitly.
provides a straightforward interface for accessing and manipulating the items for each component, including the following methods and events:
The Contains method determines whether the is currently managing a particular component.
The GetComponentActions method supports the enumeration of the lists of items.
The Add method allows adding a DesignerActionList or DesignerActionListCollection to the set of existing items for a component instance. In contrast, the Remove method removes one or all of the item lists associated with a component.
The Add method represents the direct push model of associating panel items with a component. In contrast, the pull model relies on overriding the ActionLists property of the designer class for that component. The design environment is responsible for adding these items into the current when a component is created on the design surface.
The DesignerActionListsChanged event indicates when the collection of items changes for a component.
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.
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. 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.
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.
Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.