Idioma

ContactsPickerSessionContract.ActionPickContacts Campo

Definição

Ação de intenção para iniciar o Seletor de Contatos do sistema para selecionar um ou mais contatos.

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

Valor do campo

Atributos

Comentários

Ação de intenção para iniciar o Seletor de Contatos do sistema para selecionar um ou mais contatos. Essa ação fornece uma maneira moderna de os aplicativos obterem informações de contato, diferentes de Intent.ACTION_PICK e Intent.ACTION_GET_CONTENT de várias maneiras principais: ela foi projetada especificamente para escolher contatos, oferecendo uma experiência simplificada do usuário; O aplicativo de chamada obtém acesso de leitura único aos dados de contato selecionados pelo usuário, sem a necessidade de Manifest.permission.READ_CONTACTS; Os usuários se beneficiam de uma interface do usuário consistente para conceder acesso temporário aos dados de contato; Os aplicativos cliente podem especificar e receber vários campos de dados (tipos MIME) correspondentes aos contatos selecionados

Para usar essa intenção, crie uma intenção com essa ação e inicie-a usando Activity.startActivityForResult(android.content.Intent, int). A interface do usuário do Seletor de Contatos do sistema será exibida, permitindo que o usuário selecione um ou mais contatos. Essa interface do usuário do seletor de contatos:; Ter contatos qualificados exibidos como uma lista rolável para o usuário; Permitir que os usuários selecionem contatos únicos/múltiplos; Permitir que os usuários pesquisem contatos usando o nome de exibição

O comportamento de exibição e seleção pode ser personalizado usando os seguintes extras:; EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS: (Obrigatório) Especifica os tipos MIME de dados de contato a serem exibidos no seletor e retornados ao aplicativo de chamada. Os contatos devem ter pelo menos um dos tipos MIME especificados para serem mostrados como disponíveis para seleção; EXTRA_PICK_CONTACTS_MATCH_ALL_DATA_FIELDS: (Opcional) Se definido como true, somente os contatos que possuem dados para *todos* tipos MIME especificados em EXTRA_PICK_CONTACTS_REQUESTED_DATA_FIELDS serão mostrados como disponíveis para seleção. O padrão é false; EXTRA_PICK_CONTACTS_SELECTION_LIMIT: (Opcional) Define o número máximo de contatos que o usuário pode selecionar. O padrão é 50, com um valor máximo permitido de 100; Intent.EXTRA_ALLOW_MULTIPLE: (Opcional) Se definido como true, o usuário pode selecionar vários contatos. O comportamento padrão é seleção única.

Após a seleção de contatos bem-sucedidos, o retorno de chamada Activity.onActivityResult(int, int, android.content.Intent) será invocado com Activity.RESULT_OK. A Intenção retornada conterá um URI de sessão em seu campo de dados (consulte Session.CONTENT_URI), que deve ser usado para consultar os dados de contato selecionados.

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

A partir do Android 17, essa intenção é tratada por um aplicativo do sistema por padrão. Aplicativos de terceiros não devem lidar com essa intenção, pois serão ignorados quando o sistema tentar resolvê-la.

Referência do Android para android.provider.ContactsPickerSessionContract.ACTION_PICK_CONTACTS.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a