ContactsPickerSessionContract.ExtraPickContactsRequestedDataFields フィールド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クライアント アプリケーションが要求している連絡先データの種類を指定する追加の List<String> です。
[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
フィールド値
- 属性
注釈
List<String> クライアント アプリケーションが要求している連絡先データの種類を指定する追加の値です。 この追加機能は、2 つの主な目的を果たします。**フィルター処理:** 指定した MIME の種類の少なくとも 1 つに対応するデータを持つ連絡先のみが連絡先ピッカーに表示されます。**データの戻り値:** 選択した連絡先の場合、これらの指定された MIME の種類に対応するデータのみが呼び出し元アプリケーションに返されます。この追加は、次の MIME の種類の 1 つ以上を設定する必要があります。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 タイプの *all* に対応するデータを持つ連絡先のみが表示されます。
この追加で提供されている 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);
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。