J2ME Polish
J2ME Polish 2.4 Documentation
Enough Software

Visual Guide

This guide shows you the available screens, items and screen components that you can use with J2ME Polish. Click on the UI components to learn more about them.

Screen Elements

There are several typical components in each application's user interface. Hover your mouse over the areas of interest to find out more about them.

Screen Elements 1/3
1. ScreenInfo
1. Use the ScreenInfo element to display information consistently over all screens of your application.
2. Title
2. There are various options to design screen titles, including text effects.
3. Screen Background
3. Screen backgrounds usually range from the very top to the bottom of the screen, but you can also let them start under the title and stop at the menubar.
4. ScrollBar
4. J2ME Polish uses either a scrollbar (as shown here) or simple scrollindicators to inform the user about possible scrolling.
Screen Elements 2/3
Screen Elements 3/3
7. Focused Item
7. Use the focused or the [style-name]:hover style selector to design interactive elements when they are focused by the user.
8. Ticker
8. A ticker scrolls information over a screen and can include images in J2ME Polish.

You can optionally give users a visual feedback when they press an item using the [style-name]:pressed construct.

Direct links to all screen elements:

  • Title: design the title of a screen
  • Background: design the screen's background
  • Menu Bar: design the commands and the menubar
  • Scroll Bar: design scroll indicators
  • Focused Item: design the currently focused element
  • Pressed Item: design the currently pressed element
  • Ticker: add an automatically scrolled information to a single screen
  • ScreenInfo: add a static information on all screens

Screens

J2ME Polish provides standard as well as advanced screens:

Alert

showing an Alert as popup Use the Alert to notify your user about anything important.

FilteredList

A FilteredList. The FilteredList allows you to limit the number of shown entries by entering some text. This speeds up the time for finding a specific entry in a long result list, for example.

Form

A Form in action. In a form you can embedd any kind of items for building a rich UI.

FramedForm

FramedForm The FramedForm allows you to use one scrollable main area and several fixed frames.

List

A List with a fisheye view-type. Use Lists for displaying a menu or for selecting options.

Popup Screens

showing an Alert as popup Use any screen as a popup screen.

Processing Screen

Processing The ProcessingScreen renders a Processing visualization.

SnapshotScreen

SnapshotScreen Take camera photos on your phone with the SnapshotScreen.

TabbedForm

TabbedForm The TabbedForm can contain any kind of items in several tabs.

TabbedList

Browse a complex set of options with the TabbedList. (Better documentation follows)

TabbedPane

TabbedPane The TabbedPane manages different screens in tabs.

TextBox

  The TextBox is used for text input, refer to TextField for more information.
In case you want to use a native TextBox within a J2ME Polish UI based application, just use the class name fully qualified, e.g.:
javax.microedition.lcdui.TextBox box = new javax.microedition.lcdui.TextBox("Message", null, 120, TextField.ANY );
Note that you should not use this approach for non MIDP platforms like BlackBerry.

Items

You can include Items in any Form-based screens like the TabbedForm in J2ME Polish.

CalendarItem

A CalendarItem Enter dates with a CalendarItem.

ChartItem

A ChartItem Visualize numerical data with the ChartItem.

ChoiceGroup

A ChoiceGroup with a horizontal-choice view-type Let the user select from a number of choices with a ChoiceGroup.

ChoiceTextField

A ChoiceTextField The ChoiceTextField helps you to enter correct data.

ClockItem

A ClockItem The ClockItem displays the time.

Container

Container can hold many items Different container implementations allow you to show an insane amount of data in one screen.

CustomItem

Create Your Own CustomItem Realize your own vision with a CustomItem.

DateField

A DateField Enter dates and times with a DateField.

FilteredChoiceGroup

A closed FilteredChoiceGroup Let the user select easily from a large number of choices with a FilteredChoiceGroup.

Gauge

A Gauge The Gauge visualizes activity or let the user select a value from a given range.

HtmlBrowser

The HtmlBrowser with search results from Wikipedia. The HtmlBrowser displays an image or an alternative text.

IconCustomItem

An IconCustomItem Display an image together with text using the IconCustomItem.

ImageItem

An ImageItem The ImageItem displays an image or an alternative text.

Label

A choice group with complete-background Most items support labels which are drawn in front or on top of the actual content of an item.

MessageItem

A MessageItem The MessageItem displays two different texts and an optional image.

PictureBrowserItem

Browse images with the PictureBrowserItem. (Better documentation follows)

ProcessingItem

Processing The ProcessingItem renders a Processing visualization.

RssBrowser

The RssBrowser dislaying a digg feed. Use the RssBrowser to display RSS feeds.

SpriteItem

Show an animated javax.microedition.lcdui.game.Sprite with the SpriteItem.

StringItem

A StringItem with an alien-glow text-effect Display and design text with StringItem.

TableItem

Two table items in a Form. Organize date with the TableItem.

TextField

A TextField in action You can enter input using a TextField.

Ticker

Show animated information on a screen using a Ticker. In J2ME Polish you can use Tickers like Items, as well.

TreeItem

A TreeItem in action Interact with hierarchical data with the TreeItem.
back to top