/E4WizardDemo

A simple example of a Wizard built with the Eclipse E4 Rich Client Platform. Built as a template for anyone wanting to learn more about how to build one of their own. The Wizard displays multiple pages and uses basic logic in the native Wizard methods to serve up alternate WizardPages.

Primary LanguageJava

E4WizardDemo

A simple example of a wizard built using the Eclipse E4 Rich Client Platform.

Main Page

Main Page

Wizard Page 1

Wizard Page 1

Wizard Page 2A

Wizard Page 2A

Wizard Page 2B

Wizard Page 2B

Motivation

I'm relatively new to Computer Programming and as part of my work have been learning more about building software with the Eclipse E4 Rich Client Platform. There are a number of things I've learned and one of them is how to build a Wizard with dynamically loaded pages. This example program exists to provide others a jumping off point for applying this functionality into their own apps.

Installation

This project requires the Eclipse E4 Tools to be installed:

  1. Open the "Install New Software" Window. - Navigate to the far right of the top menu and click on "Help" followed by "Install Software" near the bottom of the drop down menu.

  2. Choose the download site for your version of Eclipse. - In the drop down menu labeled "Works With" at the top of the "Install Software" window, choose the site for your Eclipse Version.

  3. Search for "E4" and install "Eclipse e4 Tools Developer Resources". - Look just below the drop down menu to find the search bar and type in "E4". Click the check box to the left of the package labeled "Eclipse e4 Tools Developer Resources" and click the "Next" button at the bottom of the window.

  4. Follow the Wizard prompts to finish installing the software.

Once the Tools have been installed, you can add this project like you would any other Java Project:

  1. Download the .zip file of this project here.
  2. Import the project. - Navigate to Eclipse, and right click in your Project Explorer, choosing "Import" about halfway down the pop-up menu. - Type "archive" into the search bar to easily locate the option titled "Archive File". Select it and click the "Next" button at the bottom of the window. - Use the "Browse" button at the top right of the next page to locate your .zip file. Select it and click the "Finish" button at the bottom of the window.

Running the Program

  1. Open WizardDemo.product
  2. On the "Overview" tab, in the "Testing" section, under item "2. Test the product by launching a runtime instance of it:", click the first link - "Launch an Eclipse Application".

Important Application.e4xmi features

  • Handler/Command
    • There is one Handler (Open Wizard) and one Command (Open Wizard) within this program's Application.e4xmi.
    • The Command consists of a Label and an ID.
    • The Handler is also given a Label and ID, but is additionally pointed towards the OpenWizard Command as well as the OpenWizard class that will run once it is activated.
    • In short, when a Command is triggered it will activate any Handlers that are pointed at it, which in turn will run any classes that are associated with those Handlers.

If you have any questions or need any help please don't hesitate to get a hold of me here, on LinkedIn, or Twitter and I will do the best I can to assist.

-Will