Creazione di un indicatore personalizzato

Nella schermata iniziale, viene visualizzato un indicatore personalizzato insieme ad altri indicatori, come l'indicatore nuovo messaggio e i promemoria del calendario. È possibile utilizzare la classe ApplicationIndicator per creare e gestire un indicatore per i messaggi personalizzati. Ad esempio, è possibile creare un indicatore per visualizzare il numero di messaggi personalizzati da leggere nell'elenco messaggi. Gli indicatori sono visibili anche quando il dispositivo BlackBerry è bloccato. L'applicazione può registrare solo un indicatore e deve registrare l'indicatore ad ogni avvio del dispositivo BlackBerry. Le dimensioni di un indicatore possono variare in base al dispositivo e al tema. Per ulteriori informazioni sulla dimensione degli indicatori, vedere le Istruzioni per l'interfaccia utente per smartphone BlackBerry.

  1. Importare le classi e le interfacce richieste.
    import net.rim.blackberry.api.messagelist.*;
    import net.rim.device.api.system.EncodedImage;
  2. Ottenere un riferimento a un oggetto ApplicationIndicatorRegistry.
    ApplicationIndicatorRegistry reg = ApplicationIndicatorRegistry.getInstance();
  3. Creare un indicatore basato su un'immagine codificata richiamando EncodedImage.getEncodedImageResource() e passando il nome del file come argomento. Salvare un riferimento all'immagine codificata in una variabile EncodedImage. Creare un'istanza della classe ApplicationIcon utilizzando EncodedImage come argomento.
    EncodedImage image = EncodedImage.getEncodedImageResource( "clowds.gif" );
    ApplicationIcon icon = new ApplicationIcon( image );
  4. Registrare l'icona come indicatore dell'applicazione, richiamando ApplicationIndicatorRegistry.register(). Nel seguente esempio di codice, il secondo parametro specifica che l'indicatore può avere un valore numerico associato (ad esempio, il totale dei nuovi messaggi). Il terzo parametro specifica che l'indicatore deve essere visibile.
    ApplicationIndicator indicator = reg.register( icon, false, true);
  5. Recuperare l'indicatore registrato richiamando ApplicationIndicatorRegistry.getApplicationIndicator(). Salvare il valore restituito in una variabile ApplicationIndicator.
    ApplicationIndicator appIndicator = reg.getApplicationIndicator();
  6. Impostare l'icona e il valore per l'indicatore richiamando ApplicationIndicator.set(). È consigliabile impostare la visualizzazione di un valore solo se è superiore a 0.
    appIndicator.set( newIcon, newValue );
Argomento successivo: Come nascondere un indicatore

Le informazioni sono state utili? Inviateci i vostri commenti.