Extending the J2ME Polish UI

• Related Topics:
• Visual Guide
• Extending the Build Process
• GUI Concepts
• CSS Basics
• Customization

You can extend the J2ME Polish UI in various ways:

• Backgrounds: create your own background
• Borders: use custom borders in your application.
• view-type: create your own visualization of an existing item
• screen-change-animation: apply your own screen transition effects
• text-effect: realize your own text-effect
• Items: extend and the standard CustomItem and design it using CSS.

Adapting J2ME Polish Classes

You can also adapt existing J2ME Polish source files to your needs. During installation choose to install the source files as well. Then you have to tell J2ME Polish where to find the client side source files using the polish.client.source Ant property, which you can define in your build.xml or within your ${user.name}.properties file, e.g.

<property name="polish.client.source" value="${polish.home}/j2mepolish-src/j2me/src/" />

You can now change the sources directly in the ${polish.client.source} folder and make a new build for including the changed classes.

Contributing Your Extensions

Please consider to contribute your extensions to the J2ME Polish project. In an open source world, everyone can participate from the work of others.

Do note, however, that J2ME Polish is used commercially as well. Please get in touch with us at j2mepolish@enough.de to discuss your contribution.

When you contribute your extension, we need the sourcecode and a complete documentation of it. Preferably the extension is documented in English, but German is also accepted. It is recommended to use the JavaDoc conventions within the code for basic documentation. The J2ME Polish project adheres to the normal Java style conventions. For distinguishing local from instance variables, please use the "this" operator for accessing instance variables. This behavior can be enforced in the Eclipse IDE by setting the compiler-option "unqualified access to instance variables".