Follow Techotopia on Twitter

On-line Guides
All Guides
eBook Store
iOS / Android
Linux for Beginners
Office Productivity
Linux Installation
Linux Security
Linux Utilities
Linux Virtualization
Linux Kernel
System/Network Admin
Programming
Scripting Languages
Development Tools
Web Development
GUI Toolkits/Desktop
Databases
Mail Systems
openSolaris
Eclipse Documentation
Techotopia.com
Virtuatopia.com

How To Guides
Virtualization
General System Admin
Linux Security
Linux Filesystems
Web Servers
Graphics & Desktop
PC Hardware
Windows
Problem Solutions
Privacy Policy

  




 

 

Eclipse Plug-in Developer Guide
Previous Page Home Next Page

Defining intro themes

A theme defines the overall appearance of the intro. It is simply a way of grouping all the presentation files (styles and images) in one place that can be pointed at or switched as one.

Definition

To define a theme, extend your intro configuration using the org.eclipse.ui.intro.configExtension and use the theme element, as shown in the example below:

   <extension
         point="org.eclipse.ui.intro.configExtension">
      <theme
            default="true"
            id="org.eclipse.ui.intro.universal.circles"
            name="%theme.name.circles"
            path="$nl$/themes/circles"
            previewImage="themes/circles/preview.png">
         <property
               name="launchbarBackground"
               value="#a1c2cb"/>
         <property
               name="launchbarOverviewIcon"
               value="$theme$graphics/launchbar/overview16.png"/>
         <property
               name="launchbarFirststepsIcon"
               value="$theme$graphics/launchbar/firststeps16.png"/>
         <property
               name="launchbarTutorialsIcon"
               value="$theme$graphics/launchbar/tutorials16.png"/>
         <property
               name="launchbarSamplesIcon"
               value="$theme$graphics/launchbar/samples16.png"/>
         <property
               name="launchbarWhatsnewIcon"
               value="$theme$graphics/launchbar/whatsnew16.png"/>
         <property
               name="launchbarMigrateIcon"
               value="$theme$graphics/launchbar/migrate16.png"/>
         <property
               name="launchbarWebresourcesIcon"
               value="$theme$graphics/launchbar/webresources16.png"/>
      </theme>
   </extension>

Consult the schema documentation for details on all the available attributes relating to themes.

Each theme has a unique identifier, translatable name, preview image, and a path to the root theme folder. The intro plug-in does not provide any UI for theme manipulation. The only way to select a theme is via the preference org.eclipse.ui.intro/INTRO_THEME in plugin_customization.ini.

Enabling themes

Theme support by itself does not make intro implementations theme-enabled. Concrete intro implementations can choose to expose themes in a more substantial way (and in fact Universal Welcome implementation does exactly that with the General > Welcome preference page.

Theme-enabled intro implementation must make all the references to style and presentation resources using the $theme$ substitution variable. Absolute paths for images, pages, styles, etc. will be computed by resolving the substitution variable using the path of the currently active theme.


 
 
  Published under the terms of the Eclipse Public License Version 1.0 ("EPL") Design by Interspire