Contributi al menu del workbench

Nei capitoli precedenti sono stati analizzati diversi punti di estensione che contribuiscono a vari menu e barre degli strumenti del workbench. Per verificare quale punto di estensione utilizzare, consultare la seguente tabella, dove sono sintetizzati i contributi che possono essere forniti ai vari menu e il relativo utilizzo.

Nome del punto di estensione

Percorso delle azioni

Dettagli

viewActions

Le azioni vengono visualizzate nella barra degli strumenti e nel menu a discesa locali di una specifica vista.

Fornire una classe di azioni che implementa IViewActionDelegate. Specificare l'ID del contributo e quello della vista di destinazione dell'azione. L'etichetta e l'immagine sono responsabili dell'aspetto dell'azione nell'interfaccia utente. Il percorso specifica la posizione rispetto alle voci della barra degli strumenti e del menu della visualizzazione.

editorActions

Le azioni sono associate a un editor e vengono visualizzate nel menu e/o nella barra degli strumenti del workbench.

Fornire una classe di azioni che implementa IEditorActionDelegate. Specificare l'ID del contributo e quello dell'editor di destinazione responsabile dell'azione. L'etichetta e l'immagine specificano l'aspetto dell'azione nell'interfaccia utente. Separare i percorsi del menu e della barra degli strumenti che specificano l'esistenza e la posizione del contributo nel menu e nella barra degli strumenti del workbench.

popupMenus

Le azioni vengono visualizzate nel menu di scelta rapida di un editor o di una vista. Le azioni associate a un tipo di oggetto appaiono in tutti i menu di scelta rapida delle viste e degli editor in cui viene mostrato il tipo di oggetto. Le azioni associate a un menu specifico di scelta rapida vengono visualizzate soltanto in quel menu.

I contributi dell'oggetto specificano il tipo di oggetto del quale visualizzare l'azione in un menu di scelta rapida. L'azione deve essere mostrata in tutti i menu di scelta rapida delle viste e degli editor che contengono il tipo di oggetto.  Fornire una classe di azioni che implementa IObjectActionDelegate
I contributi del visualizzatore specificano l'ID del menu di scelta rapida di destinazione nel quale deve essere visualizzata la voce di menu.  Fornire una classe di azioni che implementa IEditorActionDelegate o IViewActionDelegate

actionSets

Le azioni vengono visualizzate nei menu e nella barra degli strumenti principali del workbench. Le azioni sono raggruppate in insiemi. Tutte le azioni di un insieme vengono mostrate nei menu e nelle barre degli strumenti del workbench a seconda della selezione dell'insieme di azioni effettuato dall'utente e della prospettiva corrente visualizzata nel workbench.  Questa può essere influenzata da actionSetPartAssociations (vedere di seguito).

Fornire una classe di azioni che implementa IWorkbenchWindowActionDelegate o IWorkbenchWindowPulldownDelegate. Specificare name e id dell'insieme di azioni. Enumerare tutte le azioni definite per quell'insieme. Separare per ciascuna azione i percorsi del menu e della barra degli strumenti che specificano l'esistenza e la posizione del contributo nel menu e nella barra degli strumenti del workbench.

actionSetPartAssociations

Gli insiemi di azioni vengono mostrati solo quando le viste o gli editor specificati sono attivi.  Questa condizione viene ignorata se l'utente ha personalizzato la prospettiva corrente.

Specificare un insieme di azioni mediante id, seguita da una o più parti (specificate mediante id) che devono essere attive nella prospettiva corrente perché l'insieme di azioni venga mostrato.