User Guide

How to develop Java

Applications for the Nokia 9210 Communicator

Version 1.1

3.4 Status Pane API

The Status Pane API allows you to access Crystal's Status Pane (sometimes referred to as the

Indicator Area). The Status Pane is dedicated to providing different kinds of important

information such as connection, battery and field strength indicators. The API allows you to set

the style (size) of the Status Pane. There are two styles for the Status Pane: the wide area, which

has 92 x 200 pixels, and the narrow one, which has 32 x 200 pixels. The wide area also has a

place for time, the application’s icon and name.

Crystal provides a class in the com.symbian.epoc.awt package that allows Java programs to

control the Status Pane. The API can be used by both applets and applications.

3.5 Virtual Cursor API

The Virtual Cursor (VC, i.e. Pointer) is a useful UI extension providing users with a software

pointer in the absence of a hardware pointer (e.g. mouse pointer). The Pointer is useful in

applications that explicitly require pointer events. For example, image maps on a web browser

requiring pointer events can be handled by the Pointer: the VC is enabled and its actions are

received as normal pointer events by the browser application.

Crystal provides a class in the com.symbian.epoc.awt package that allows Java programs to

control the Pointer and receive pointer events from it. The API can be used by both applets and

applications.

More information about Symbian classes can be found after SDK installation in the

documentation: Crystal V6 Edition for Java -> Crystal Java API Reference -> package

com.symbian.epoc.awt and C:\Symbian\6.0\NokiaJava\erj\utilities\Awt\JavaDoc\index.html.

4. SHORT CODE EXAMPLE

In this chapter we have a short code example. The example code gives basic knowledge about

developing Java applications for the Nokia 9210 Communicator (and Crystal platform). The

application is a simple "Hello World!"-application. It is based on the CBADemo application

included with the SDK CD-ROM. This documentation presumes that the SDK is installed in the

default folder c:\Symbian\6.0\NokiaJava\.