Crear un indicador personalizado

Los indicadores personalizados aparecen en la pantalla Inicio junto con otros indicadores, como el indicador de mensajes nuevos y los avisos del calendario. Puede utilizar la clase ApplicationIndicator para crear y administrar un indicador para mensajes personalizados. Por ejemplo, puede crear un indicador para mostrar el número de mensajes personalizados sin leer que hay la lista de mensajes. Los indicadores son visibles aún cuando el dispositivo BlackBerry está bloqueado. Su aplicación puede registrar sólo un indicador y debe registrarlo cada vez que se inicia el dispositivo BlackBerry. El tamaño del indicador puede variar según el dispositivo y el tema. Para obtener más información sobre el tamaño de un indicador, consulte las Directrices sobre IU paraBlackBerry BlackBerry.

  1. Importe las clases y las interfaces necesarias.
    import net.rim.blackberry.api.messagelist.*;
    import net.rim.device.api.system.EncodedImage;
  2. Obtenga una referencia a un objeto ApplicationIndicatorRegistry.
    ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry.getInstance();
  3. Cree un indicador basado en una imagen codificada invocando EncodedImage.getEncodedImageResource() y pasando el nombre de archivo como un argumento. Guarde una referencia a la imagen codificada en una variable EncodedImage. Cree una instancia de la clase ApplicationIcon utilizando EncodedImage como un argumento.
    EncodedImage image = EncodedImage.getEncodedImageResource( "clowds.gif" );
    ApplicationIcon icon = new ApplicationIcon( image );
  4. Registre el icono como un indicador de aplicación invocando ApplicationIndicatorRegistry.register(). En el siguiente ejemplo de código, el segundo parámetro especifica que el indicador puede tener un valor numérico asociado (por ejemplo, un nuevo recuento de mensajes). El tercer parámetro especifica que el indicador debe ser visible.
    ApplicationIndicator indicator = reg.register( icon, false, true);
  5. Recupere el indicador registrado invocando ApplicationIndicatorRegistry.getApplicationIndicator(). Guarde el valor devuelto en una variable ApplicationIndicator.
    ApplicationIndicator appIndicator = reg.getApplicationIndicator();
  6. Establezca el icono y el valor para el indicador invocando ApplicationIndicator.set(). Considere mostrar el valor sólo si es mayor que 0.
    appIndicator.set( newIcon, newValue );
Tema siguiente: Ocultar un indicador

¿Le ha resultado útil esta información? Envíenos sus comentarios.