Elementy wnoszone menu środowiska roboczego

W poprzednich sekcjach występowało już kilka różnych punktów rozszerzeń, które wnosiły akcje do różnych menu i pasków narzędzi w środowisku roboczym. Skąd wiadomo, którego z nich użyć? Poniższa tabela zawiera podsumowanie różnych elementów wnoszonych do menu i ich zastosowania.

Nazwa punktu rozszerzenia

Położenie akcji

Szczegóły

viewActions

Akcje są wnoszone do lokalnego paska narzędzi i lokalnego menu rozwijanego konkretnego widoku.

Wnosi klasę akcji, która implementuje interfejs IViewActionDelegate. Należy określić identyfikator elementu wnoszonego i identyfikator widoku docelowego, w którym powinna być wyświetlana akcja. Etykieta i obrazek określają wygląd akcji w interfejsie użytkownika. Ścieżka określa położenie względem pozycji menu i paska narzędzi widoku.

editorActions

Akcje są powiązane z edytorem i są wyświetlane w menu i/lub na pasku narzędzi środowiska roboczego.

Wnosi klasę akcji, która implementuje interfejs IEditorActionDelegate. Należy określić identyfikator elementu wnoszonego i identyfikator edytora docelowego, który ma powodować wyświetlanie akcji. Etykieta i obrazek określają wygląd akcji w interfejsie użytkownika. Osobne ścieżki menu i paska narzędzi określają istnienie i położenie elementu wnoszonego w menu i na pasku narzędzi środowiska roboczego.

popupMenus

Akcje są wyświetlane w menu podręcznym edytora lub widoku. Akcje powiązane z typem obiektu są wyświetlane we wszystkich menu podręcznych widoków i edytorów, w których wyświetlany jest obiekt tego typu. Akcje powiązane z konkretnym menu podręcznym są wyświetlane tylko w tym menu.

Elementy wnoszone obiektów określają typ obiektu, dla którego akcja powinna być wyświetlana w menu podręcznym. Akcja będzie wyświetlana we wszystkich menu podręcznych widoków i edytorów, które zawierają obiekt danego typu.  Należy udostępnić klasę akcji, która implementuje interfejs IObjectActionDelegate
Elementy wnoszone przeglądarki określają identyfikator docelowego menu podręcznego, w którym powinna być wyświetlana pozycja menu.  Należy udostępnić klasę akcji, która implementuje interfejs IEditorActionDelegate lub interfejs IViewActionDelegate

actionSets

Akcje są wyświetlane w głównych menu i na pasku narzędzi środowiska roboczego. Akcje są pogrupowane w zbiory akcji. Wszystkie akcje z danego zbioru akcji będą wyświetlane w menu i na pasku narzędzi środowiska roboczego zgodnie z dokonanym przez użytkownika wyborem zbiorów akcji i bieżącą perspektywą wyświetlaną w środowisku roboczym.  Na ten punkt rozszerzeń może mieć wpływ punkt rozszerzeń actionSetPartAssociations (opisany poniżej).

Należy wnieść klasę akcji, która implementuje interfejs IWorkbenchWindowActionDelegate lub interfejs IWorkbenchWindowPulldownDelegate. Należy także określić atrybuty name i id zbioru akcji. Wszystkie akcje zdefiniowane w danym zbiorze akcji powinny zostać wymienione. Dla każdej akcji osobne ścieżki menu i paska narzędzi określają istnienie i położenie elementu wnoszonego w menu i na pasku narzędzi środowiska roboczego.

actionSetPartAssociations

Zbiory akcji są wyświetlane tylko wtedy, gdy określone widoki lub edytory są aktywne.  Warunek ten jest ignorowany, gdy użytkownik dostosował bieżącą perspektywę.

Należy określić zbiór akcji przy użyciu atrybutu id oraz podać jedną lub więcej części (też przy użyciu atrybutu id), które muszą być aktywne w bieżącej perspektywie, aby dany zbiór akcji został wyświetlony.