Création d'un indicateur personnalisé

Un indicateur personnalisé s'affiche sur l'écran d'accueil avec d'autres indicateurs, comme l'indicateur de nouveau message et les rappels de calendrier. Vous pouvez utiliser la classe ApplicationIndicator pour créer et gérer un indicateur pour les messages personnalisés. Par exemple, vous pouvez créer un indicateur pour afficher le nombre de messages personnalisés non lus dans la liste des messages. Les indicateurs sont visibles même lorsque le terminal BlackBerry est verrouillé. Votre application peut enregistrer un seul indicateur et doit enregistrer l'indicateur à chaque démarrage du terminal BlackBerry. La taille d'un indicateur peut varier en fonction du terminal et du thème. Pour plus d'informations sur la taille d'un indicateur, consultez les Instructions relatives à l'interface utilisateur des smartphones BlackBerry.

  1. Importez les classes et les interfaces requises.
    import net.rim.blackberry.api.messagelist.*;
    import net.rim.device.api.system.EncodedImage;
  2. Obtenez une référence à un objet ApplicationIndicatorRegistry.
    ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry.getInstance();
  3. Créez un indicateur basé sur une image codée en appelant EncodedImage.getEncodedImageResource() et en transmettant le nom de fichier comme argument. Enregistrez une référence à l'image codée dans une variable EncodedImage. Créez une instance de la classe ApplicationIcon à l'aide d'un argument EncodedImage.
    EncodedImage image = EncodedImage.getEncodedImageResource( "clowds.gif" );
    ApplicationIcon icon = new ApplicationIcon( image );
  4. Enregistrez l'icône en tant qu'indicateur d'application en appelant ApplicationIndicatorRegistry.register(). Dans l'échantillon de code suivant, le deuxième paramètre spécifie que l'indicateur peut avoir une valeur numérique associée (par exemple, le nombre de nouveaux messages). Le troisième paramètre spécifie que l'indicateur doit être visible.
    ApplicationIndicator indicator = reg.register( icon, false, true);
  5. Récupérez l'indicateur enregistré en appelant ApplicationIndicatorRegistry.getApplicationIndicator(). Enregistrez la valeur renvoyée dans une variable ApplicationIndicator.
    ApplicationIndicator appIndicator = reg.getApplicationIndicator();
  6. Enregistrez l'icône et la valeur de l'indicateur en appelant ApplicationIndicator.set(). Vous devriez envisager d'afficher uniquement les valeurs supérieures à zéro.
    appIndicator.set( newIcon, newValue );
Sujet suivant: Masquer un indicateur

Ces informations vous ont-elles été utiles ? Envoyez-nous vos commentaires.