Title bar

Use a title bar to provide BlackBerry® device users with information at the top of your application. Most title bars contain only a title, but title bars can display the following items:

  • application icon, descriptive title, and time
  • application notifications, such as a new message indicator
  • wireless connection indicators, including the wireless coverage level, network coverage, GPS indicator, Bluetooth® indicator, and Wi-Fi® connection indicator
  • battery power indicator
  • active call indicator
Class StandardTitleBar
Supported since BlackBerry® Java® SDK 6.0
Example This screen shows a title bar.

For more information about title bars, see the UI Guidelines.

Code sample: Creating a title bar

import net.rim.device.api.ui.*; 
import net.rim.device.api.ui.component.*; 
import net.rim.device.api.ui.container.*; 

public class TitleBarDemo extends UiApplication 
{
    public static void main(String[] args)
    {
        TitleBarDemo theApp = new TitleBarDemo();
        theApp.enterEventDispatcher();
    }
    public TitleBarDemo()
    {
        pushScreen(new TitleBarDemoScreen());
    } 
}
class TitleBarDemoScreen extends MainScreen
{
    public TitleBarDemoScreen()
    {
        StandardTitleBar myTitleBar = new StandardTitleBar()
            .addIcon("my_logo.png")
            .addTitle("Title Bar Demo")
            .addClock()
            .addNotifications()
            .addSignalIndicator();
        myTitleBar.setPropertyValue(StandardTitleBar.PROPERTY_BATTERY_VISIBILITY,
            StandardTitleBar.BATTERY_VISIBLE_LOW_OR_CHARGING);
        setTitleBar(myTitleBar);
     }
}
Next topic: Map field
Previous topic: Browser field

Was this information helpful? Send us your comments.