Jump to: navigation, search

Difference between revisions of "Rich Client Platform/Custom Look and Feel"

(More Information)
(Presentation layer has been deprecated in Eclipse 4.x)
 
(8 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
{{RCP}}
 +
{{note | The Presentation layer has been deprecated in Eclipse 4.x in favour of the more powerful [[Eclipse4/RCP/CSS|CSS styling feature]].}}
 +
 
The presentation of your [[Rich Client Platform]] application can be changed using the org.eclipse.ui.presentationFactories extension point.  
 
The presentation of your [[Rich Client Platform]] application can be changed using the org.eclipse.ui.presentationFactories extension point.  
  
Line 36: Line 39:
 
* If you are not using the update configurator, then remember to edit the osgi.bundles property (in ./eclipse/configuration/config.ini) to include the new plug-in.
 
* If you are not using the update configurator, then remember to edit the osgi.bundles property (in ./eclipse/configuration/config.ini) to include the new plug-in.
 
* Run: <code>eclipse.exe -clean</code> (the -clean argument forces eclipse to check for newly installed or removed plug-ins)
 
* Run: <code>eclipse.exe -clean</code> (the -clean argument forces eclipse to check for newly installed or removed plug-ins)
 +
 +
== Custom window layout==
 +
It is also possible to have a custom layout of the overall workbench window, by overriding [http://help.eclipse.org/help31/topic/org.eclipse.platform.doc.isv/reference/api/org/eclipse/ui/application/WorkbenchWindowAdvisor.html#createWindowContents(org.eclipse.swt.widgets.Shell) WorkbenchWindowAdvisor.createWindowContents(Shell)].
 +
For example, some applications use this to add a branding banner at the top.
 +
Note that this mechanism is independent of the presentation mechanism described above.
  
 
==More information==
 
==More information==
Line 42: Line 50:
 
* [http://dev.eclipse.org/viewcvs/index.cgi/*checkout*/org.eclipse.ui.examples.presentation/eclipsecon2005-presentationsAPI.ppt?rev=1.1&content-type=application/powerpoint PPT slides] from the [http://www.eclipsecon.org/2005/sessions.php EclipseCon 2005 talk] "Presentations API - the look and feel of Eclipse".
 
* [http://dev.eclipse.org/viewcvs/index.cgi/*checkout*/org.eclipse.ui.examples.presentation/eclipsecon2005-presentationsAPI.ppt?rev=1.1&content-type=application/powerpoint PPT slides] from the [http://www.eclipsecon.org/2005/sessions.php EclipseCon 2005 talk] "Presentations API - the look and feel of Eclipse".
 
* Martin Perez's [http://jroller.com/page/mpermar?entry=eclipse_presentations_jlibrary_and_vs blog entry on presentations]
 
* Martin Perez's [http://jroller.com/page/mpermar?entry=eclipse_presentations_jlibrary_and_vs blog entry on presentations]
 +
* Jeff McAffer and Jean-Michel Lemieux's, "[http://www.chapters.indigo.ca/books/item/books-978032133461/0321334612/Eclipse+Rich+Client+Platform+Designing+Coding+And+Packaging+?ref=Search+Books%3a+'rich+client+platform'&sterm=rich+client+platform+-+Books Eclipse Rich Client Platform]" discusses customizing the presentation in chapter 19.
  
 
==Other presentation implementations==
 
==Other presentation implementations==
 
* [http://sourceforge.net/projects/eclipse-skins VS Presentation] by Willian Mitsuda
 
* [http://sourceforge.net/projects/eclipse-skins VS Presentation] by Willian Mitsuda
 
* [http://andrei.gmxhome.de/skins/index.html Extended VS Presentation] by Andrei Loskutov (based on Willian's)
 
* [http://andrei.gmxhome.de/skins/index.html Extended VS Presentation] by Andrei Loskutov (based on Willian's)
 +
* [http://www.eclipse.org/nebula/widgets/presentation_shelf/presentation_shelf.php Nebula PShelf-based Presentation] (alpha version)
 +
* [http://sourceforge.net/projects/metaleclipse/ Eclipse metal]
 +
[[Category:RCP]]
 +
* [http://max-server.myftp.org/trac/mp3m MP3 Manager Presentation] by Kai Tödter

Latest revision as of 16:32, 27 April 2012

RCP
Home
How to Contribute
FAQ
Note.png
The Presentation layer has been deprecated in Eclipse 4.x in favour of the more powerful CSS styling feature.


The presentation of your Rich Client Platform application can be changed using the org.eclipse.ui.presentationFactories extension point.

This example will show how to use the R2.1 presentation, provided by the org.eclipse.ui.presentations.r21 plugin, in the RCP Browser Example application. Here is a screen shot of the browser example using the R2.1 presentation.

The following steps will deploy the plugin into the RCP application and activate it by setting some preferences.

  • Deploy the RCP browser example by following these instructions.
  • Build and deploy the org.eclipse.ui.presentations.r21 plugin.
  • Copy the file eclipse/plugins/org.eclipse.ui.presentations.r21_3.1.0/r21presentation.ini into the directory eclipse/plugins/org.eclipse.ui.examples.rcp.browser_3.1.0.
  • Edit eclipse/plugins/org.eclipse.ui.examples.rcp.browser_3.1.0/plugin.xml so that the products extension looks like:
   <extension
         point="org.eclipse.core.runtime.products"
         id="product">
      <product
            name="%productName"
            application="org.eclipse.ui.examples.rcp.browser.app">
         <property
               name="appName"
               value="%swtAppName"/>
         <property
               name="windowImages"
               value="icons/eclipse.gif,icons/eclipse32.gif"/>
         <property
               name="aboutText"
               value="%aboutText"/>
         <property
               name="aboutImage"
               value="icons/eclipse_lg.gif"/>
         <property
               name="preferenceCustomization"
               value="r21presentation.ini"/>
      </product>
   </extension>
  • If you are not using the update configurator, then remember to edit the osgi.bundles property (in ./eclipse/configuration/config.ini) to include the new plug-in.
  • Run: eclipse.exe -clean (the -clean argument forces eclipse to check for newly installed or removed plug-ins)

Custom window layout

It is also possible to have a custom layout of the overall workbench window, by overriding WorkbenchWindowAdvisor.createWindowContents(Shell). For example, some applications use this to add a branding banner at the top. Note that this mechanism is independent of the presentation mechanism described above.

More information

Other presentation implementations