ContactsPickerSessionContract.ActionPickContacts Campo

[Android.Runtime.Register("ACTION_PICK_CONTACTS", ApiSince=37)]
public const string ActionPickContacts;

[<Android.Runtime.Register("ACTION_PICK_CONTACTS", ApiSince=37)>]
val mutable ActionPickContacts : string

Valore del campo

Attributi

RegisterAttribute

Commenti

Azione di intento per avviare il sistema Selezione contatti per selezionare uno o più contatti. Questa azione offre un modo moderno per le applicazioni di ottenere informazioni di contatto, diverse da Intent.ACTION_PICK e Intent.ACTION_GET_CONTENT in diversi modi chiave: è progettato specificamente per la selezione dei contatti, offrendo un'esperienza utente semplificata; L'applicazione chiamante ottiene l'accesso in lettura monouso ai dati di contatto selezionati dall'utente, senza richiedere Manifest.permission.READ_CONTACTS; Gli utenti traggono vantaggio da un'interfaccia utente coerente per concedere l'accesso temporaneo ai dati di contatto; Le applicazioni client possono specificare e ricevere più campi dati (tipi MIME) corrispondenti ai contatti selezionati

Per usare questa finalità, creare una finalità con questa azione e avviarla usando Activity.startActivityForResult(android.content.Intent, int). Verrà visualizzata l'interfaccia utente selezione contatti di sistema, consentendo all'utente di selezionare uno o più contatti. Questa interfaccia utente selezione contatti: Avere contatti idonei visualizzati come un elenco scorrevole per l'utente; Consentire agli utenti di selezionare contatti singoli/multipli; Consentire agli utenti di cercare contatti usando il nome visualizzato

Il comportamento di visualizzazione e selezione può essere personalizzato usando i seguenti elementi aggiuntivi: EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS: (Obbligatorio) Specifica i tipi MIME di dati di contatto da visualizzare nella selezione e restituiti all'app chiamante. I contatti devono avere almeno uno dei tipi MIME specificati per essere visualizzati come disponibili per la selezione; EXTRA_PICK_CONTACTS_MATCH_ALL_DATA_FIELDS: (Facoltativo) Se impostato su true, verranno visualizzati solo i contatti che possiedono dati per i tipi MIME *all* specificati in EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS. Il valore predefinito è false; EXTRA_PICK_CONTACTS_SELECTION_LIMIT: (Facoltativo) Definisce il numero massimo di contatti che l'utente può selezionare. Il valore predefinito è 50, con un valore massimo consentito pari a 100; Intent.EXTRA_ALLOW_MULTIPLE: (Facoltativo) Se impostato su true, l'utente può selezionare più contatti. Il comportamento predefinito è a selezione singola.

Al termine della selezione dei contatti, il callback Activity.onActivityResult(int, int, android.content.Intent) verrà richiamato con Activity.RESULT_OK. La finalità restituita conterrà un URI di sessione nel relativo campo dati (vedere Session.CONTENT_URI), che deve essere usato per eseguire query sui dati di contatto selezionati.

Uri sessionUri = data.getData();
Cursor cursor = getContentResolver().query(sessionUri, projection, null, null, null);
// Process cursor data

A partire da Android 17, questa finalità viene gestita da un'applicazione di sistema per impostazione predefinita. Le applicazioni di terze parti non devono gestire questa finalità perché verranno ignorate quando il sistema tenta di risolverlo.

Informazioni di riferimento su Android per android.provider.ContactsPickerSessionContract.ACTION_PICK_CONTACTS.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.