ContactsPickerSessionContract.ExtraPickContactsRequestedDataFields 欄位

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

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

欄位值

屬性

RegisterAttribute

備註

一個<List String> extra，用來指定客戶端應用程式所請求的聯絡資料類型。 此額外內容有兩個主要目的：**過濾：** 只有擁有至少一種指定 MIME 類型資料的聯絡人才會在聯絡人選擇器中顯示;**資料回傳：** 對於選定的聯絡人，只有對應這些指定 MIME 類型的資料會回傳給呼叫應用程式。此額外資料必須填入以下一種或多種 MIME 類型：ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.Organization.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.Relation.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.Event.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.Photo.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.GroupMembership.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.Website.CONTENT_ITEM_TYPE;ContactsContract.CommonDataKinds.Nickname.CONTENT_ITEM_TYPE

若 EXTRA_PICK_CONTACTS_MATCH_ALL_DATA_FIELDS 設為 true，則僅顯示包含本額外內容中所有 MIME 類型的聯絡人資料。

如果本額外內容中任何 MIME 類型不在上述允許類型中，聯絡人選擇器會拋出 IllegalArgumentException。

客戶必須設定此額外資訊，以確保挑選者能判斷哪些資訊應提供供選擇。

List<String> requestedMimeTypes = new ArrayList<>();
requestedMimeTypes.add(ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE);
requestedMimeTypes.add(ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE);
intent.putStringArrayListExtra(
        ContactsPickerSessionContract.EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS,
        (ArrayList<String>) requestedMimeTypes);

Android 參考資料。android.provider.ContactsPickerSessionContract.EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。