DesignerActionService Classe

Definizione

Crea un servizio in fase di progettazione per la gestione della raccolta di oggetti DesignerActionItem per i componenti.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
Ereditarietà
DesignerActionService
Derivato
Implementazioni

Commenti

La DesignerActionService classe è responsabile della gestione della raccolta di DesignerActionItem oggetti per ogni istanza di un componente presente in un modulo in fase di progettazione.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. Questa classe Abilita un modello Direct Push della creazione di elementi ed è destinata principalmente agli sviluppatori di strumenti della fase di progettazione, anche se può essere usata anche da sviluppatori di controlli di componenti e personalizzati.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.

Gli sviluppatori di strumenti in fase di progettazione dovranno determinare l'elenco di elementi da visualizzare per un componente e determinare quando questo elenco viene modificato.Design-time tool developers will need to determine the list of items to display for a component and determine when this list changes. Possono inoltre creare componenti aggiuntivi che operano insieme agli oggetti del pannello smart tag.They may also create add-ins that operate in conjunction with smart tag panel objects.

Gli sviluppatori di componenti avanzati potrebbero dover controllare dinamicamente gli elementi associati a un componente, sostituendo o integrando il modello pull standard.Advanced component developers may need to dynamically control the items associated with a component, thus replacing or supplementing the standard pull model. È ad esempio possibile modificare i comandi del pannello a seconda del contesto dell'utilizzo e dello stato della fase di progettazione 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

Il DesignerActionService è in realtà il servizio di guida alla base dei modelli push e pull; tuttavia, nel secondo caso funziona in modo implicito.The DesignerActionService is actually the driving service behind both the push and pull models; however, in the latter case it operates implicitly.

DesignerActionServicefornisce un'interfaccia semplice per l'accesso e la modifica degli elementi per ogni componente, inclusi i metodi e gli eventi seguenti:DesignerActionService provides a straightforward interface for accessing and manipulating the items for each component, including the following methods and events:

  • Il Contains metodo determina se l' DesignerActionService oggetto sta attualmente gestendo un particolare componente.The Contains method determines whether the DesignerActionService is currently managing a particular component.

  • Il GetComponentActions metodo supporta l'enumerazione degli elenchi di elementi.The GetComponentActions method supports the enumeration of the lists of items.

  • Il Add metodo consente di aggiungere DesignerActionList un DesignerActionListCollection oggetto o al set di elementi esistenti per un'istanza del componente.The Add method allows adding a DesignerActionList or DesignerActionListCollection to the set of existing items for a component instance. Al contrario, il Remove metodo rimuove uno o tutti gli elenchi di elementi associati a un componente.In contrast, the Remove method removes one or all of the item lists associated with a component.

    Nota

    Il Add metodo rappresenta il modello Direct Push dell'associazione degli elementi del pannello a un componente.The Add method represents the direct push model of associating panel items with a component. Al contrario, il modello pull si basa sull'override della ActionLists proprietà della classe della finestra di progettazione per quel componente.In contrast, the pull model relies on overriding the ActionLists property of the designer class for that component. L'ambiente di progettazione è responsabile dell'aggiunta di questi elementi all' DesignerActionService oggetto corrente quando viene creato un componente nell'area di progettazione.The design environment is responsible for adding these items into the current DesignerActionService when a component is created on the design surface.

    Importante

    I Addmetodi Remove ,,eClear considerano o influiscono solo sugli elementi del modello push. ContainsThe Add, Remove, Contains, and Clear methods only consider or affect push-model items.

  • L' DesignerActionListsChanged evento indica quando la raccolta di elementi viene modificata per un componente.The DesignerActionListsChanged event indicates when the collection of items changes for a component.

Poiché è spesso consigliabile utilizzare alcuni degli stessi elementi del pannello nel menu di scelta rapida della fase di progettazione del componente e nel relativo pannello, esiste un elevato livello di interoperabilità DesignerActionItem tra oggetti e verbi della finestra di progettazione.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.

Se una finestra di progettazione di componenti non specifica in DesignerActionList modo esplicito un oggetto, ovvero non contiene una proprietà ActionLists sottoposta a override, viene creato un elenco da verbi di progettazione esistenti.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. Questi verbi sono specificati dalla Verbs proprietà.These verbs are specified by the Verbs property. In questo caso, viene usata una classe di elenco di verbi interni per contenere la raccolta di voci del pannello degli elementi del verbo.In this case, an internal verb list class is used to contain the collection of verb item panel entries.

Se si vuole usare DesignerActionMethodItem un oggetto sia come voce del pannello sia come voce del menu di scelta rapida della fase di progettazione, è possibile includeAsDesignerVerb impostare il parametro nel costruttore dell'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.

Utilizzare per controllare la visualizzazione delle finestre di ActionListsprogettazione. DesignerActionUIServiceUse the DesignerActionUIService to control the display of your designer's ActionLists.

Costruttori

DesignerActionService(IServiceProvider)

Inizializza una nuova istanza della classe DesignerActionService.Initializes a new instance of the DesignerActionService class.

Metodi

Add(IComponent, DesignerActionList)

Aggiunge un oggetto DesignerActionList all'insieme corrente di smart tag gestiti.Adds a DesignerActionList to the current collection of managed smart tags.

Add(IComponent, DesignerActionListCollection)

Aggiunge un oggetto DesignerActionListCollection all'insieme corrente di smart tag gestiti.Adds a DesignerActionListCollection to the current collection of managed smart tags.

Clear()

Rilascia tutti i componenti dalla gestione e cancella tutti gli elenchi di smart tag del modello push.Releases all components from management and clears all push-model smart tag lists.

Contains(IComponent)

Determina se il servizio smart tag corrente gestisce gli elenchi di azioni del componente specificato.Determines whether the current smart tag service manages the action lists for the specified component.

Dispose()

Rilascia tutte le risorse usate dalla classe DesignerActionService.Releases all resources used by the DesignerActionService class.

Dispose(Boolean)

Rilascia le risorse non gestite usate da DesignerActionService e, facoltativamente, le risorse gestite.Releases the unmanaged resources used by the DesignerActionService and optionally releases the managed resources.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetComponentActions(IComponent)

Restituisce l'insieme degli elenchi di elementi smart tag associati a un componente.Returns the collection of smart tag item lists associated with a component.

GetComponentActions(IComponent, ComponentActionsType)

Restituisce l'insieme degli elenchi di elementi smart tag del tipo specificato associati a un componente.Returns the collection of smart tag item lists of the specified type associated with a component.

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

Recupera gli smart tag del modello pull associati a un componente.Retrieves the pull-model smart tags associated with a component.

GetComponentServiceActions(IComponent, DesignerActionListCollection)

Recupera gli smart tag del modello push associati a un componente.Retrieves the push-model smart tags associated with a component.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
Remove(DesignerActionList)

Rimuove l'elenco di smart tag specificato da tutti i componenti gestiti dal servizio corrente.Removes the specified smart tag list from all components managed by the current service.

Remove(IComponent)

Rimuove tutti gli elenchi di smart tag associati al componente specificato.Removes all the smart tag lists associated with the specified component.

Remove(IComponent, DesignerActionList)

Rimuove l'elenco di smart tag specificato dal componente indicato.Removes the specified smart tag list from the specified component.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Eventi

DesignerActionListsChanged

Si verifica quando si aggiunge o si rimuove un oggetto DesignerActionList per un componente.Occurs when a DesignerActionList is removed or added for any component.

Si applica a

Vedi anche