Difference between revisions of "E4/EAS/Updating UI Elements"

Revision as of 13:52, 10 November 2009

Any application that's not for kiosks will generally have some menus and a couple of tool bar items for the user to interact with. There may also be arrays of tabs to provide a view of the information that the user may be interested in. As the information and context of the application alters, these user interface elements may need to be updated.

Commands often have two different representations on the user interface. Consider the save command for example, it has an entry in the 'File' menu and it is also displayed the tool bar as a clickable tool item. If this command's displayed text needs to be altered, say, if its keybinding has changed, then both its UI representation as a menu item and a tool item needs to be updated.

Eclipse 3.x API

Updating a part's name

In Eclipse 3.x, a workbench part can alter its tab's text with the setPartName(String) method.

public class MyPart extends ViewPart {
  private void render(Model model) {
    setPartName(model.getName());
  }
}

Updating a part's image

In Eclipse 3.x, a workbench part can alter its tab's image with the setTitleImage(Image) method.

public class MyPart extends ViewPart {
  private void render(Model model) {
    setTitleImage(getImage(model));
  }
 
  private Image getImage(Model model) {
    /* implementation not shown */
  }
}

e4 (Java)

Updating a part's name

Injection can be used for retrieving the "owning" UI item. The client can then set its name directly.

public class MyPart {
 
  @Inject
  private MUIItem uiItem;
 
  private void render(Model model) {
    uiItem.setName(model.getName());
  }
}

Updating a part's image

Injection can be used for retrieving the "owning" UI item. The client can then set its image directly.

public class MyPart {
 
  @Inject
  private MUIItem uiItem;
 
  private void render(Model model) {
    uiItem.setIconUri(getImageURI(model));
  }
 
  private String getImageURI(Model model) {
    /* implementation not shown */
  }
}