| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"> |
| <html> |
| <head> |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2005. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." > |
| <title>Eclipse RCP Browser Example</title> |
| <meta http-equiv=Content-Type content="text/html; charset=ISO-8859-1"> |
| </head> |
| <body lang="EN-US"> |
| <h2>Eclipse RCP Browser Example</h2> |
| |
| <p>Last updated May 21, 2004</p> |
| |
| <h3>Description</h3> |
| <p>This is an example of a simple Eclipse Rich Client Platform (RCP) application. |
| It is a bare bones web browser, using the SWT Browser control. |
| </p> |
| <p> |
| The code is in package <code>org.eclipse.ui.examples.browser</code>, and consists |
| of an application class (<code>BrowserApp</code>), a workbench advisor for |
| configuring the workbench (<code>BrowserAdvisor</code>), and a single perspective |
| (<code>BrowserPerspectiveFactory</code>) containing a single view (<code>BrowserView</code>). |
| </p> |
| <p> |
| The application defines several built-in actions in the menu and toolbar that are |
| typical for web browsers (Back, Forward, Stop, Refresh). These are added in |
| <code>BrowserActionBuilder</code> when a new window is opened (see |
| <code>BrowserAdvisor.fillActionBars(...)</code>). These actions are defined as |
| retargetable actions, for which the view registers handling actions. |
| </p> |
| <p> |
| The view consists of an address bar (a <code>Label</code> and a <code>Text</code> |
| control) and the <code>Browser</code> control. To handle status and progress |
| events, it simply passes on the relevant events from the <code>Browser</code> |
| control to the Workbench status line. |
| |
| <h3>Running the example</h3> |
| To run the RCP Browser example from within the Eclipse SDK: |
| <ol> |
| <li>Load project org.eclipse.ui.examples.rcp.browser |
| from the Eclipse repository into a self-hosting workspace.</li> |
| <li>Create a new "Run-time workbench" launch configuration called "Browser Example".</li> |
| <li>On the "Arguments" tab, select "Run a product" and choose select "org.eclipse.ui.examples.rcp.browser.product" from the drop-down.</li> |
| <li>On the "Plug-ins" tab, configure it to include only the |
| required plug-ins: |
| <ul> |
| <li>Press "Deselect All"</li> |
| <li>Check "org.eclipse.ui.examples.rcp.browser"</li> |
| <li>Press "Add Required Plug-ins"</li> |
| <li>Check "org.eclipse.update.configurator"</li> |
| </ul> |
| </li> |
| <li>Run or debug the launch config.</li> |
| </body> |
| </html> |