DesignerActionService Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.ComponentModel.Design
Assembly:
System.Design.dll
Assembly:
System.Windows.Forms.Design.dll

Crea un servizio in fase di progettazione per la gestione della raccolta di oggetti DesignerActionItem per i componenti.

public ref class DesignerActionService : IDisposable
public class DesignerActionService : IDisposable
type DesignerActionService = class
    interface IDisposable
Public Class DesignerActionService
Implements IDisposable
Ereditarietà
Object
DesignerActionService
Derivato
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.

Nota

In DesignerActionService realtà il servizio di guida dietro i modelli push e pull, tuttavia, in quest'ultimo caso opera in modo implicito.

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

DesignerActionService(IServiceProvider)

Inizializza una nuova istanza della classe DesignerActionService.

Metodi

Add(IComponent, DesignerActionList)

Aggiunge un oggetto DesignerActionList all'insieme corrente di smart tag gestiti.
Add(IComponent, DesignerActionListCollection)

Aggiunge un oggetto DesignerActionListCollection all'insieme corrente di smart tag gestiti.
Clear()

Rilascia tutti i componenti dalla gestione e cancella tutti gli elenchi di smart tag del modello push.
Contains(IComponent)

Determina se il servizio smart tag corrente gestisce gli elenchi di azioni del componente specificato.
Dispose()

Rilascia tutte le risorse usate dalla classe DesignerActionService.
Dispose(Boolean)

Rilascia le risorse non gestite usate da DesignerActionService e, facoltativamente, le risorse gestite.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetComponentActions(IComponent)

Restituisce l'insieme degli elenchi di elementi smart tag associati a un componente.
GetComponentActions(IComponent, ComponentActionsType)

Restituisce l'insieme degli elenchi di elementi smart tag del tipo specificato associati a un componente.
GetComponentActions(IComponent, ComponentActionsType)

Restituisce l'insieme di elenchi di elementi di azione della finestra di progettazione del tipo specificato associati a un componente.
GetComponentDesignerActions(IComponent, DesignerActionListCollection)

Recupera gli smart tag del modello pull associati a un componente.
GetComponentServiceActions(IComponent, DesignerActionListCollection)

Recupera gli smart tag del modello push associati a un componente.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
Remove(DesignerActionList)

Rimuove l'elenco di smart tag specificato da tutti i componenti gestiti dal servizio corrente.
Remove(IComponent)

Rimuove tutti gli elenchi di smart tag associati al componente specificato.
Remove(IComponent, DesignerActionList)

Rimuove l'elenco di smart tag specificato dal componente indicato.
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Eventi

DesignerActionListsChanged

Si verifica quando si aggiunge o si rimuove un oggetto DesignerActionList per un componente.

Si applica a

Vedi anche