ContactsPickerSessionContract.ActionPickContacts Feld

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

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

Feldwert

Attribute

RegisterAttribute

Hinweise

Absichtsaktion zum Starten der Systemkontaktauswahl, um einen oder mehrere Kontakte auszuwählen. Diese Aktion bietet eine moderne Möglichkeit für Anwendungen, Kontaktinformationen zu erhalten, die sich von Intent.ACTION_PICK und Intent.ACTION_GET_CONTENT auf verschiedene Wichtige Weise unterscheiden: Sie ist speziell für die Auswahl von Kontakten konzipiert und bietet eine optimierte Benutzererfahrung; Die aufrufende Anwendung erhält einmaligen Lesezugriff auf die vom Benutzer ausgewählten Kontaktdaten, ohne dass Manifest.permission.READ_CONTACTS erforderlich sind; Benutzer profitieren von einer konsistenten Benutzeroberfläche, um temporären Zugriff auf ihre Kontaktdaten zu gewähren; Clientanwendungen können mehrere Datenfelder (MIME-Typen) angeben und empfangen, die den ausgewählten Kontakten entsprechen.

Um diese Absicht zu verwenden, erstellen Sie eine Absicht mit dieser Aktion, und starten Sie sie mit Activity.startActivityForResult(android.content.Intent, int). Die Benutzeroberfläche der Systemkontaktauswahl wird angezeigt, sodass der Benutzer einen oder mehrere Kontakte auswählen kann. Diese Benutzeroberflächen für die Kontaktauswahl:; Lassen Sie berechtigte Kontakte als bildlauffähige Liste für den Benutzer angezeigt werden. Benutzern die Auswahl einzelner/mehrerer Kontakte ermöglichen; Ermöglichen, dass Benutzer mithilfe des Anzeigenamens nach Kontakten suchen

Das Anzeige- und Auswahlverhalten kann mithilfe der folgenden Extras angepasst werden:; EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS: (Erforderlich) Gibt die MIME-Typen von Kontaktdaten an, die in der Auswahl angezeigt und an die aufrufende App zurückgegeben werden sollen. Kontakte müssen mindestens einen der angegebenen MIME-Typen aufweisen, damit sie zur Auswahl zur Verfügung stehen; EXTRA_PICK_CONTACTS_MATCH_ALL_DATA_FIELDS: (Optional) Wenn dieser Wert auf "true" festgelegt ist, werden nur Kontakte mit Daten für *all* MIME-Typen angezeigt, die in EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS angegeben sind, als für die Auswahl verfügbar. Standardwert ist "false"; EXTRA_PICK_CONTACTS_SELECTION_LIMIT: (Optional) Definiert die maximale Anzahl von Kontakten, die der Benutzer auswählen kann. Der Standardwert ist 50, wobei der maximal zulässige Wert 100 ist; Intent.EXTRA_ALLOW_MULTIPLE: (Optional) Wenn "true" festgelegt ist, kann der Benutzer mehrere Kontakte auswählen. Das Standardverhalten ist single-select.

Nach erfolgreicher Auswahl von Kontakten wird der Activity.onActivityResult(int, int, android.content.Intent)-Rückruf mit Activity.RESULT_OK aufgerufen. Die zurückgegebene Absicht enthält einen Sitzungs-URI im Datenfeld (siehe Session.CONTENT_URI), der zum Abfragen der ausgewählten Kontaktdaten verwendet werden soll.

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

Ab Android 17 wird diese Absicht standardmäßig von einer Systemanwendung behandelt. Anwendungen von Drittanbietern sollten diese Absicht nicht behandeln, da sie ignoriert werden, wenn das System versucht, sie aufzulösen.

Android-Referenz für android.provider.ContactsPickerSessionContract.ACTION_PICK_CONTACTS.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.