Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Eclipse4/API/AppContext"
(→EPartService) |
(→ECommandService) |
||
Line 32: | Line 32: | ||
Provides API to construct Commands.<br> | Provides API to construct Commands.<br> | ||
− | + | :ECommandService allows interaction with the Command API, accessing commands and creating parameterized commands for execution. It's like a global dictionary. [[User:Pwebster.ca.ibm.com|Pwebster.ca.ibm.com]] | |
− | + | ||
− | + | ||
=== EHandlerService === | === EHandlerService === |
Revision as of 08:32, 8 March 2013
Contents
Services and Context Values
This section will describe which elements are guaranteed to be available for injection through the IEclipseContext. The most common of these will be the 'standard' services but will also reference some other 'value' elements (i.e. the injected value is *not* an interface itself but some discreet value such as a preference or model event).
Basic Services
EModelService
This service presents API appropriate for working with the UI Model. If contains methods to search for model elements via a variety of search parameters a well as operations that can be used to manipulate the model to achieve changes in the UI.
EPartService
This service provides API that deals with the runtime aspects of managin the current workbench UI such as opening new parts or getting / setting the 'active' part...
- Can currently NOT used to open new parts as you cannot define the container, see https://bugs.eclipse.org/bugs/show_bug.cgi?id=390971 Lars.Vogel@gmail.com
EBindingService
This service allows manipulation of the key binding structures.
- This services is used by the model to push key bindings into the runtime. It needs polish and I don't think it should be API for Kepler. Pwebster.ca.ibm.com
EContextService
Provides API to control the active 'chain' within a context structure.
- The EContextService is important to programmatic clients, for activating contexts in their @PostConstruct or managing context activations based on the state of their controls (which widgets have focus, etc). Pwebster.ca.ibm.com
- Except for deferUpdates(*), that should be marked as @noreference Pwebster.ca.ibm.com
ECommandService
Provides API to construct Commands.
- ECommandService allows interaction with the Command API, accessing commands and creating parameterized commands for execution. It's like a global dictionary. Pwebster.ca.ibm.com
EHandlerService
This provides API to manage Handlers.
Why do the Execute methods take in Parameterized Commands (perhaps Execute should be in the CommandService and take a Handler?)
What's 'getContext' for ?
EMenuService
Provides a single API to register context menus.
In the UI Model a MPart can have any number of menus, each with a unique id. Do we need this or should we have a 'showMenu(id)' method ?<span style="font-style: italic;" />
ESelectionService
This allows for registration of listeners regarding the current selection. Note that this has more functionality in it than the @Inject approach since it provides 'post selection' (i.e. deferred) listeners as well as regular listeners.
IEventBroker
Allows access to the OSGI event broker and can be used to register / unregister listeners on the UIModel.