Um indicador personalizado é exibido na tela inicial junto com outros indicadores, como o indicador de mensagem nova e lembretes do calendário. Você pode usar a classe ApplicationIndicator para criar e gerenciar um indicador para mensagens personalizadas. Por exemplo, você pode criar um indicador para exibir o número de mensagens personalizadas não lidas na lista de mensagens. Os indicadores são visíveis mesmo quando o aparelho BlackBerry está bloqueado. Seu aplicativo pode registrar apenas um indicador e deve registrar o indicador cada vez que o aparelho BlackBerry é iniciado. O tamanho de um indicador pode variar dependendo do aparelho e tema. Para obter mais informações sobre o tamanho de um indicador, consulte as Diretrizes de UI para smartphonesBlackBerry.

1. Importe as classes e interfaces necessárias.

   import net.rim.blackberry.api.messagelist.*;
   import net.rim.device.api.system.EncodedImage;

2. Obtenha uma referência a um objeto ApplicationIndicatorRegistry.

   ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry.getInstance();

3. Crie um indicador com base em uma imagem codificada invocando EncodedImage.getEncodedImageResource() e passando o nome do arquivo como um argumento. Salve uma referência à imagem codificada em uma variável EncodedImage. Crie uma instância da classe ApplicationIcon usando EncodedImage como um argumento.

   EncodedImage image = EncodedImage.getEncodedImageResource( "clowds.gif" );
   ApplicationIcon icon = new ApplicationIcon( image );

4. Registre o ícone como um indicador de aplicativo invocando ApplicationIndicatorRegistry.register(). No exemplo de código a seguir, o segundo parâmetro especifica que o indicador pode ter um valor numérico associado a ele (por exemplo, contagem de novas mensagens). O terceiro parâmetro especifica que o indicador deve ser visível.

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

5. Recupere o indicador registrado invocando ApplicationIndicatorRegistry.getApplicationIndicator(). Salve o valor de retorno em uma variável ApplicationIndicator.

   ApplicationIndicator appIndicator = reg.getApplicationIndicator();

6. Defina o ícone e valor para o indicador invocando ApplicationIndicator.set(). Você deve considerar a exibição somente de valores maiores que 0.

   appIndicator.set( newIcon, newValue );