schema.rap.themeableWidgets.exsd Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of org.eclipse.rap.ui
The RAP Widget Toolkit Eclipse UI Components
The newest version!




      
         
      
      
         This extension point is used to register custom RWT widgets which also support theming.
To support theming, a widget provides a couple of files that are relevant for the theming. These files must conform to a naming convention. Once a custom widget is registered with this extension point, the theme-relevant files are found by their names. Thus, only the custom widget class must be registered.
<p>
The custom widget must provide the theme-relevant files in a package with is named after the schema <code>&lt;package&gt;.internal.&lt;widget&gt;kit</code> where <code>&lt;package&gt;</code> is the package name and <code>&lt;widget&gt;</code> is the lower case class name of the custom control. This is the same package that also contains the lifecycle adapter (LCA).
<p>
Theming relevant files include:
<ul>
  <li>A theme definiton file with the name <code>&lt;Widget&gt;.theme.xml</code>. This file defines new theming keys.</li>
  <li>A theme adapter class that implements <code>ControlThemeAdapter</code> and is named <code>&lt;Widget&gt;ThemeAdapter</code>. The theme adapter provides the control with the current values of theming-dependent properties.</li>
  <li>An appearance fragment file with the name <code>&lt;Widget&gt;.appearances.js</code>. This file defines new qooxdoo appearances.</li>
</ul>
None of these files are mandatory, files which are found are respected, but files which are missing do not hurt.
      
   

   
      
         
            
         
         
            
               

               
            
         
         
            
               

               
            
         
         
            
               

               
               
                  
               
            
         
      
   

   
      
         
            
         
      
      
         
            
               
                  a unique name that identifies this themeable widget
               
            
         
         
            
               
                  an optional name for the themable widget
               
            
         
         
            
               
                  the name of a class that implements the custom widget
               
               
                  
               
            
         
      
   

   
      
         
      
      
         RAP 1.0
      
   

   
      
         
      
      
         The following is an example of a themeable widget extension definition:
<pre>
<extension
    point="org.eclipse.rap.ui.themeableWidgets">
  <widget
      id="my.custom.datepicker"
      class="my.custom.controls.DatePicker">
  </widget>
</extension>
</pre>
      
   

   
      
         
      
      

      
   

   
      
         
      
      

      
   

   
      
         
      
      
         Copyright (c) 2007, 2015 EclipseSource and others.<br>
All rights reserved. This program and the accompanying materials are made
available under the terms of the Eclipse Public License v1.0 which accompanies
this distribution, and is available at <a
href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a>