Create an indicator for the number of messages in a custom folder

Search This Document

Download PDF

Import the following classes:
- net.rim.blackberry.api.messagelist.ApplicationIndicatorRegistry
- net.rim.device.api.system.EncodedImage
- net.rim.blackberry.api.messagelist.ApplicationIcon
- net.rim.blackberry.api.messagelist.ApplicationIndicator
Store a reference to an ApplicationIndicatorRegistry in an ApplicationIndicatorRegistry variable.
```
ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry.getInstance();
```
To create an encoded image from an image, invoke EncodedImage.getEncodedImageResource using the name of the image file as an argument. Save a reference to the encoded image in an EncodedImage variable.
```
EncodedImage image = EncodedImage.getEncodedImageResource( "clowds.gif" );
```
To create an BlackBerry® device application icon based on the encoded image, create an instance of an ApplicationIcon using an EncodedImage as an argument.
```
ApplicationIcon icon = new ApplicationIcon( image );
```

Use an icon with an application indicator.

ApplicationIndicator indicator = reg.register( icon, false, true);

To retrieve the indicator that theBlackBerry device application registered, invoke ApplicationIndicatorRegistry.getApplicationIndicator() and store the return value in an ApplicationIndicator variable.
```
ApplicationIndicator AppIndicator = reg.getApplicationIndicator();
```
To set the icon and value of an indicator, invoke ApplicationIndicator.set().
```
AppIndicator.set( newIcon, newValue );
```

Parent topic: Using custom messages and folders in the message list