DesignerActionService Classe

Definizione

public ref class DesignerActionService : IDisposable

public class DesignerActionService : IDisposable

type DesignerActionService = class
    interface IDisposable

Public Class DesignerActionService
Implements IDisposable

Ereditarietà

Object

DesignerActionService

Derivato

System.Web.UI.Design.WebFormsDesignerActionService

Implementazioni

IDisposable

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. Questa classe consente un modello push diretto della creazione dell'elemento ed è destinato principalmente all'uso da parte degli sviluppatori di strumenti di progettazione, anche se può essere usato anche dagli sviluppatori di componenti e controlli personalizzati.

Gli sviluppatori di strumenti in fase di progettazione dovranno determinare l'elenco di elementi da visualizzare per un componente e determinare quando questo elenco cambia. Possono anche creare componenti aggiuntivi che operano insieme agli oggetti del pannello smart tag.

Gli sviluppatori di componenti avanzati potrebbero dover controllare dinamicamente gli elementi associati a un componente, sostituendo o integrando il modello di pull standard. Ad esempio, i comandi del pannello possono essere modificati a seconda del contesto dell'uso e dello stato di progettazione del componente.

DesignerActionService fornisce un'interfaccia semplice per accedere e modificare gli elementi per ogni componente, inclusi i metodi e gli eventi seguenti:

• Il Contains metodo determina se attualmente la DesignerActionService gestione di un componente specifico.

• Il GetComponentActions metodo supporta l'enumerazione degli elenchi di elementi.

• Il Add metodo consente di aggiungere o DesignerActionListCollectionDesignerActionList al set di elementi esistenti per un'istanza del componente. Al contrario, il Remove metodo rimuove uno o tutti gli elenchi di elementi associati a un componente.

  Nota

  Il Add metodo rappresenta il modello push diretto degli elementi del pannello associati a un componente. Al contrario, il modello pull si basa sull'override ActionLists della proprietà della classe di progettazione per tale componente. L'ambiente di progettazione è responsabile dell'aggiunta di questi elementi nell'oggetto corrente DesignerActionService quando viene creato un componente nell'area di progettazione.

  Importante

  I Addmetodi , Remove, Containse considerano Clear o influiscono solo sugli elementi del modello push.

• L'evento DesignerActionListsChanged indica quando la raccolta di elementi cambia per un componente.

Poiché spesso è consigliabile usare alcuni degli stessi elementi del pannello nel menu di scelta rapida in fase di progettazione del componente e nel relativo pannello, esiste un gran grado di interoperabilità tra DesignerActionItem gli oggetti e i verbi della finestra di progettazione.

Se una finestra di progettazione componenti non specifica in modo esplicito un oggetto DesignerActionList ,ovvero non contiene una proprietà sottoposto a override, verrà creato un ActionLists elenco dai verbi della finestra di progettazione esistenti. Questi verbi vengono specificati dalla Verbs proprietà . In questo caso, viene usata una classe elenco verbo interna per contenere la raccolta di voci del pannello degli elementi verbi.

Se si vuole usare un DesignerActionMethodItem oggetto sia come voce del pannello che come voce di menu di scelta rapida in fase di progettazione, è possibile impostare il includeAsDesignerVerb parametro nel costruttore dell'elemento.

Usare per DesignerActionUIService controllare la visualizzazione della finestra di progettazione.ActionLists

Costruttori

Metodi

Eventi

Si applica a

Vedi anche

• DesignerActionListCollection
• ComponentDesigner
• DesignerActionItem
• DesignerActionUIService
• Comandi della finestra di progettazione e modello a oggetti DesignerAction per Windows Form