Skip to main content
Jump to: navigation, search


< Eclipse4‎ | API
Revision as of 16:23, 5 March 2013 by (Talk | contribs) (Concrete Classes)

UI Model

The UI Model is used to describe the various components of an application's User Interface. This model is an abstract definition that is rendered into reality on a particular platform through the use of a presentation engine driving a set of renderers (usually but not limited to one renderer part UI Model type.

The model itself is based on EMF. One of the things that EMF does a really good job at is allowing multiple inheritance so the basic design of the model starts with low-level components that can then be aggregated into concrete classes.

The model itself is composed from a number of different type of elements which are used to define the 'concrete' UI elements (i.e. the ones that actually get rendered):


Used to contain the attributes for different concepts such as label information or containment types. These will be useful when we eventually start to derive domain-specific models based on the current one.







Containment Definitions

In order to facilitate the use of Java generics each container may only contain elements of a single 'type' (interface really). These elements represent the type that is legal in a given container. In order to make an element legal for a given container add that container's type as one of the mix-ins for the class being contained.

WindowElement - Elements that can be added to a Window's list of children:

  • Part
  • PartStack
  • PartSashContainer

TrimElement - Elements that can be added to a TrimBar

  • ToolBar
  • ToolControl

PartSashContainerElement - Elements that can be added to a PartSashContainer

  • Part
  • PartStack
  • PartSashContainer (it's recursive)

StackElement - Elements that can be added to a PartStack

  • Part
  • Placeholder

Concrete Classes

These define the true UI model as used to present an applicaton. The UI Model has been broken down into a number of discreet packages, the sections below will be based on the contents of each package:

Basic UI

This package contains the most elementary of the UI components:




    MTrimBar (contained by an MTrimmedWindow but not in its list of children)







 Basic UI (Descriptors)

This Package contains the 'descriptors' for various elements. Currently only PartDescriptors are supported but over time we may well want to include other types such as PerspectiveDescriptors. Essentially this is the e4 way to capture the set of available views that a user may wish to open and from which the actual MPart can be instantiated.


Advanced UI

This package contains the elements necessary to support more complex UI's such as are required by the Eclipse IDE itself such as Perspectives and (editor) Areas.





Copyright © Eclipse Foundation, Inc. All Rights Reserved.