Criar um indicador personalizado

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 );
Próximo tópico: Ocultar um indicador

Estas informações foram úteis? Gostaríamos de receber seus comentários.