English
Instant Developer Foundation Documentazione
  • Reference Librerie
  • Librerie Componenti
  • Shell

Get Contacts

funzione copia link

Scopo

Restituisce tutti i contatti presenti sul dispositivo. Sui dispositivi iOS la funzione restituisce tutti i contatti visibili all'interno dell'applicazione Contatti.

Sintassi

IDArray contatti = Shell.getContacts()

Argomenti

La funzione non ha argomenti.

Valore di ritorno

Viene restituito un IDArray contenente tante istanze di tipo ShellContact quanti sono i contatti presenti sul dispositivo. Se l'applicazione non è in esecuzione all'interno della Shell Nativa la funzione restituisce il NULL.

Esempio di codice

// ****************
// Leggo i contatti
// ****************

public void Contatti.GetContacts()
{
  IDArray cont = Shell.getContacts()
  // 
  // Se sono offline, la risposta è già arrivata

  if (AppMobile.isOffline())
  {
    this.GetContactsReply(cont)
  }
  else  // Sono online... devo aspettare la risposta
  {
    // Se non è ancora arrivata la risposta, faccio un altro giro di timer
    if (cont == null)
      ContactTimer.enabled = true
    else  // Arrivata... fermo il timer e analizzo
    {
      ContactTimer.enabled = false
      this.GetContactsReply(cont)
    }
  }
}
  • Questa procedura è statica.
  • Attenzione: Se l'applicazione è offline la funzione restituisce subito l'array contenente i contatti poiché l'applicazione è interamente contenuta nel dispositivo. Se l'applicazione non è offline la funzione restituisce subito il valore NULL ed invia la richiesta alla Shell Nativa. Quando quest'ultima ha preparato la risposta la invia al server web che la conserva in memoria. Occorre, pertanto, chiamare periodicamente la funzione GetContacts fino a quando non si ottiene una risposta diversa da NULL. Per sapere se l'applicazione è online o offline è possibile utilizzare la funzione di libreria IsOffline.
  • Dalla versione 18.0 sui dispositivi con Android Marshmallow o superiore viene richiesta preventivamente la permission per usare leggere la rubrica.

Ultima modifica: 30/07/2018 / Validità: da 11.0.4800

Vedi Anche

  • ID Array
  • Shell Contact
  • Shell Contact Address
  • Is Offline (funzione)

Hai trovato utile l'articolo?

Grazie per il feedback!

Ti serve altro aiuto?

Consulta il Forum