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.

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.
5. MenuBar: 5. Choose between two menubar options that provide different design possibilities.

6. MenuBar: 6. With J2ME Polish you can use sub menus as well.

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

Use the Alert to notify your user about anything important.

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

In a form you can embedd any kind of items for building a rich UI.

FramedForm

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

List

Use Lists for displaying a menu or for selecting options.

Use any screen as a popup screen.

SnapshotScreen

Take camera photos on your phone with the SnapshotScreen.

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

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

Enter dates with a CalendarItem.

ChartItem

Visualize numerical data with the ChartItem.

ChoiceGroup

Let the user select from a number of choices with a ChoiceGroup.

ChoiceTextField

The ChoiceTextField helps you to enter correct data.

ClockItem

The ClockItem displays the time.

CustomItem

Realize your own vision with a CustomItem.

DateField

Enter dates and times with a DateField.

FilteredChoiceGroup

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

Gauge

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

HtmlBrowser

The HtmlBrowser displays an image or an alternative text.

IconCustomItem

Display an image together with text using the IconCustomItem.

ImageItem

The ImageItem displays an image or an alternative text.

Label

Most items support labels which are drawn in front or on top of the actual content of an item.

MessageItem

The MessageItem displays two different texts and an optional image.

PictureBrowserItem

Browse images with the PictureBrowserItem. (Better documentation follows)

RssBrowser

Use the RssBrowser to display RSS feeds.

SpriteItem

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

StringItem

Display and design text with StringItem.

TableItem

Organize date with the TableItem.

TextField

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

Interact with hierarchical data with the TreeItem.

Username:
Password: