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)
}
}
}
// 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