DesignerActionService DesignerActionService DesignerActionService DesignerActionService Class

Definición

Establece un servicio en tiempo de diseño que administra la colección de objetos DesignerActionItem para componentes.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
Herencia
DesignerActionServiceDesignerActionServiceDesignerActionServiceDesignerActionService
Derivado
Implementaciones

Comentarios

La DesignerActionService clase es responsable de administrar la colección de DesignerActionItem objetos para cada instancia de un componente que existe en un formulario en tiempo de diseño.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. Esta clase habilita un modelo de inserciones directas de la creación de elementos y está pensado principalmente para su uso por parte de los desarrolladores de herramientas en tiempo de diseño, aunque también lo pueden usar los desarrolladores de componentes y controles personalizados.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.

Los desarrolladores de herramientas en tiempo de diseño deberán determinar la lista de elementos que se van a mostrar para un componente y determinar cuándo cambia esta lista.Design-time tool developers will need to determine the list of items to display for a component and determine when this list changes. También pueden crear complementos que funcionan junto con los objetos del panel de etiquetas inteligentes.They may also create add-ins that operate in conjunction with smart tag panel objects.

Los desarrolladores de componentes avanzados pueden necesitar controlar dinámicamente los elementos asociados a un componente, reemplazando o complementando el modelo de extracción estándar.Advanced component developers may need to dynamically control the items associated with a component, thus replacing or supplementing the standard pull model. Por ejemplo, se pueden modificar los comandos del panel según el contexto de su uso y el estado en tiempo de diseño del componente.For example, panel commands can be altered depending on the context of their use and the design-time state of the component.

Nota

DesignerActionService Es realmente el servicio de conducción subyacente a los modelos de inserción y extracción; sin embargo, en el segundo caso funciona implícitamente.The DesignerActionService is actually the driving service behind both the push and pull models; however, in the latter case it operates implicitly.

DesignerActionServiceproporciona una interfaz sencilla para obtener acceso a los elementos de cada componente y manipularlos, incluidos los siguientes métodos y eventos:DesignerActionService provides a straightforward interface for accessing and manipulating the items for each component, including the following methods and events:

  • El Contains método determina DesignerActionService si está administrando actualmente un componente determinado.The Contains method determines whether the DesignerActionService is currently managing a particular component.

  • El GetComponentActions método admite la enumeración de las listas de elementos.The GetComponentActions method supports the enumeration of the lists of items.

  • El Add método permite DesignerActionList agregar o DesignerActionListCollection al conjunto de elementos existentes para una instancia del componente.The Add method allows adding a DesignerActionList or DesignerActionListCollection to the set of existing items for a component instance. En cambio, el Remove método quita una o todas las listas de elementos asociadas a un componente.In contrast, the Remove method removes one or all of the item lists associated with a component.

    Nota

    El Add método representa el modelo de envío directo de Asociación de elementos de panel con un componente.The Add method represents the direct push model of associating panel items with a component. En cambio, el modelo de extracción se basa en la invalidación de la ActionLists propiedad de la clase de diseñador para ese componente.In contrast, the pull model relies on overriding the ActionLists property of the designer class for that component. El entorno de diseño es responsable de agregar estos elementos al actual DesignerActionService cuando se crea un componente en la superficie de diseño.The design environment is responsible for adding these items into the current DesignerActionService when a component is created on the design surface.

    Importante

    Los Addmétodos Remove, ,Contains yClear solo tienen en cuenta o afectan a los elementos de modelo de extracción.The Add, Remove, Contains, and Clear methods only consider or affect push-model items.

  • El DesignerActionListsChanged evento indica cuándo cambia la colección de elementos para un componente.The DesignerActionListsChanged event indicates when the collection of items changes for a component.

Dado que a menudo es conveniente usar algunos de los mismos elementos de panel en el menú contextual del componente en tiempo de diseño y en su panel, existe un gran grado de DesignerActionItem interoperabilidad entre los objetos y los verbos del diseñador.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.

Si un diseñador de componentes no especifica DesignerActionList explícitamente (es decir, no contiene una propiedad invalidada ActionLists ), se creará una lista a partir de los verbos de diseñador existentes.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. Estos verbos se especifican mediante la Verbs propiedad.These verbs are specified by the Verbs property. En este caso, se usa una clase de lista de verbos interna para contener la colección de entradas del panel de elementos de verbo.In this case, an internal verb list class is used to contain the collection of verb item panel entries.

Si desea DesignerActionMethodItem que se use como una entrada de panel y una entrada de menú contextual en tiempo de diseño, puede establecer el includeAsDesignerVerb parámetro en el constructor del elemento.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.

Utilice para controlar la presentación de la del ActionListsdiseñador. DesignerActionUIServiceUse the DesignerActionUIService to control the display of your designer's ActionLists.

Constructores

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

Inicializa una nueva instancia de la clase DesignerActionService.Initializes a new instance of the DesignerActionService class.

Métodos

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

Agrega un objeto DesignerActionList a la colección actual de etiquetas inteligentes administradas.Adds a DesignerActionList to the current collection of managed smart tags.

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

Agrega un objeto DesignerActionListCollection a la colección actual de etiquetas inteligentes administradas.Adds a DesignerActionListCollection to the current collection of managed smart tags.

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

Libera todos los componentes de la administración y borra todas las listas de etiquetas inteligentes de modelo de inserción.Releases all components from management and clears all push-model smart tag lists.

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

Determina si el servicio actual de etiquetas inteligentes administra las listas de acciones para el componente especificado.Determines whether the current smart tag service manages the action lists for the specified component.

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

Libera todos los recursos que utiliza la clase DesignerActionService.Releases all resources used by the DesignerActionService class.

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

Libera los recursos no administrados que usa DesignerActionService y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the DesignerActionService and optionally releases the managed resources.

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

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

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

Devuelve la colección de listas de elementos de etiqueta inteligente asociados a un componente.Returns the collection of smart tag item lists associated with a component.

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

Devuelve la colección de listas de elementos de etiqueta inteligente del tipo especificado asociado a un componente.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)

Recupera las etiquetas inteligentes del modelo de extracción asociadas a un componente.Retrieves the pull-model smart tags associated with a component.

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

Recupera las etiquetas inteligentes del modelo de inserción asociadas a un componente.Retrieves the push-model smart tags associated with a component.

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

Sirve como la función hash predeterminada.Serves as the default hash function.

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

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

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

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

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

Quita la lista de etiquetas inteligentes especificada de todos los componentes administrados mediante el servicio actual.Removes the specified smart tag list from all components managed by the current service.

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

Quita todas las listas de etiquetas inteligentes asociadas al componente especificado.Removes all the smart tag lists associated with the specified component.

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

Quita la lista de etiquetas inteligentes especificada del componente determinado.Removes the specified smart tag list from the specified component.

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

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Eventos

DesignerActionListsChanged DesignerActionListsChanged DesignerActionListsChanged DesignerActionListsChanged

Se produce cuando se quita o agrega un objeto DesignerActionList para cualquier componente.Occurs when a DesignerActionList is removed or added for any component.

Se aplica a

Consulte también: