Compartir vía

DesignerActionService Clase

  • Referencia

Definición

Espacio de nombres:
System.ComponentModel.Design
Ensamblado:
System.Design.dll
Ensamblado:
System.Windows.Forms.Design.dll

Establece un servicio en tiempo de diseño que administra la colección de objetos DesignerActionItem para componentes.

public ref class DesignerActionService : IDisposable
public class DesignerActionService : IDisposable
type DesignerActionService = class
    interface IDisposable
Public Class DesignerActionService
Implements IDisposable
Herencia
Object
DesignerActionService
Derivado
Implementaciones
IDisposable

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. Esta clase permite un modelo de inserción directa de 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 puede ser utilizado por los desarrolladores de controles personalizados y componentes.

Los desarrolladores de herramientas en tiempo de diseño deberán determinar la lista de elementos que se mostrarán para un componente y determinar cuándo cambia esta lista. También pueden crear complementos que funcionen junto con objetos de panel de etiquetas inteligentes.

Es posible que los desarrolladores de componentes avanzados necesiten controlar dinámicamente los elementos asociados a un componente, reemplazando o complementando el modelo de extracción estándar. Por ejemplo, los comandos de panel se pueden modificar según el contexto de su uso y el estado en tiempo de diseño del componente.

Nota

DesignerActionService en realidad es el servicio de conducción detrás de los modelos de inserción y extracción; sin embargo, en el último caso, funciona implícitamente.

DesignerActionService proporciona una interfaz sencilla para acceder y manipular los elementos de cada componente, incluidos los métodos y eventos siguientes:

  • El Contains método determina si DesignerActionService está administrando actualmente un componente determinado.

  • El GetComponentActions método admite la enumeración de las listas de elementos.

  • El Add método permite agregar o DesignerActionListDesignerActionListCollection al conjunto de elementos existentes para una instancia de componente. En cambio, el Remove método quita una o todas las listas de elementos asociadas a un componente.

    Nota

    El Add método representa el modelo de inserción directa de asociar elementos de panel con un componente. En cambio, el modelo de extracción se basa en invalidar la ActionLists propiedad de la clase de diseñador para ese componente. 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.

    Importante

    Los Addmétodos , Remove, Containsy Clear solo consideran o afectan a los elementos del modelo de inserción.

  • El DesignerActionListsChanged evento indica cuándo cambia la colección de elementos de un componente.

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

Si un diseñador de componentes no especifica explícitamente un DesignerActionList objeto (es decir, no contiene una propiedad invalidada ActionLists ), se creará una lista a partir de verbos de diseñador existentes. Estos verbos se especifican mediante la Verbs propiedad . En este caso, se usa una clase interna de lista de verbos para contener la colección de entradas del panel de elementos de verbo.

Si desea usar un elemento DesignerActionMethodItem como 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.

DesignerActionUIService Use para controlar la presentación de la colección del ActionListsdiseñador.

Constructores

DesignerActionService(IServiceProvider)

Inicializa una nueva instancia de la clase DesignerActionService.

Métodos

Add(IComponent, DesignerActionList)

Agrega un objeto DesignerActionList a la colección actual de etiquetas inteligentes administradas.
Add(IComponent, DesignerActionListCollection)

Agrega un objeto DesignerActionListCollection a la colección actual de etiquetas inteligentes administradas.
Clear()

Libera todos los componentes de la administración y borra todas las listas de etiquetas inteligentes de modelo de inserción.
Contains(IComponent)

Determina si el servicio actual de etiquetas inteligentes administra las listas de acciones para el componente especificado.
Dispose()

Libera todos los recursos que utiliza la clase DesignerActionService.
Dispose(Boolean)

Libera los recursos no administrados que usa DesignerActionService y, de forma opcional, libera los recursos administrados.
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetComponentActions(IComponent)

Devuelve la colección de listas de elementos de etiqueta inteligente asociados a un componente.
GetComponentActions(IComponent, ComponentActionsType)

Devuelve la colección de listas de elementos de etiqueta inteligente del tipo especificado asociado a un componente.
GetComponentActions(IComponent, ComponentActionsType)

Devuelve la colección de listas de elementos de acción del diseñador del tipo especificado asociado a un componente.
GetComponentDesignerActions(IComponent, DesignerActionListCollection)

Recupera las etiquetas inteligentes del modelo de extracción asociadas a un componente.
GetComponentServiceActions(IComponent, DesignerActionListCollection)

Recupera las etiquetas inteligentes del modelo de inserción asociadas a un componente.
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
Remove(DesignerActionList)

Quita la lista de etiquetas inteligentes especificada de todos los componentes administrados mediante el servicio actual.
Remove(IComponent)

Quita todas las listas de etiquetas inteligentes asociadas al componente especificado.
Remove(IComponent, DesignerActionList)

Quita la lista de etiquetas inteligentes especificada del componente determinado.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Eventos

DesignerActionListsChanged

Se produce cuando se quita o agrega un objeto DesignerActionList para cualquier componente.

Se aplica a

Consulte también