ContactsContract.Contacts Classe

Definição

[Android.Runtime.Register("android/provider/ContactsContract$Contacts", DoNotGenerateAcw=true)]
public class ContactsContract.Contacts : Java.Lang.Object

[<Android.Runtime.Register("android/provider/ContactsContract$Contacts", DoNotGenerateAcw=true)>]
type ContactsContract.Contacts = class
    inherit Object

Herança

Object

JavaObject

Object

ContactsContract.Contacts

Atributos

RegisterAttribute

Comentários

Constantes para a tabela de contatos, que contém um registro por agregação de contatos brutos que representam a mesma pessoa. <H3>As operações</h3><dl dt><><b>Insert</b></dt><dd>A Contact não podem ser criadas explicitamente. Quando um contato bruto é inserido, o provedor primeiro tentará encontrar um Contato representando a mesma pessoa. Se um for encontrado, a coluna do RawContacts#CONTACT_ID contato bruto obterá o _ID do Contato de agregação. Se nenhuma correspondência for encontrada, o provedor inserirá automaticamente um novo Contato e colocará seu _ID na RawContacts#CONTACT_ID coluna do contato bruto recém-inserido.</dd><dt><b>Atualização</b></dt><dd>Somente determinadas colunas de Contato são modificáveis: #STARRED, , #CUSTOM_RINGTONE. #SEND_TO_VOICEMAIL Alterar qualquer uma dessas colunas no Contato também as altera em todos os contatos brutos constituintes.</dd><dt><b>Delete</b></dt><dd>Tenha cuidado com a exclusão de Contatos! Excluir um contato agregado exclui todos os contatos brutos constituintes. Os adaptadores de sincronização correspondentes observarão as exclusões de seus respectivos contatos brutos e os removerão do armazenamento de back-end.</dd><dt><b>Query</b></dt><dd><ul><li>Se precisar ler um contato individual, considere usar #CONTENT_LOOKUP_URI em vez de #CONTENT_URI.</li><li>Se você precisar procurar um contato pelo número de telefone, use PhoneLookup#CONTENT_FILTER_URI PhoneLookup.CONTENT_FILTER_URI, que é otimizado para essa finalidade.</li><li>Se você precisar procurar um contato por nome parcial, por exemplo, para produzir sugestões de filtro conforme o tipo, use o #CONTENT_FILTER_URI URI. <li>Se você precisar procurar um contato por algum elemento de dados, como endereço de email, apelido etc, use uma consulta na ContactsContract.Data tabela. O resultado conterá ID de contato, nome etc. </ul>/dd<>/dl<>h2<Columns>/h2<>table class="jd-sumtable"<>tr<>th colspan='4'Contacts<>/th<>/tr<>tr<>td<long>/td td<><>#_ID/td td<><read-only>/td td<>td<Row ID.> Considere usar #LOOKUP_KEY em vez disso.</td/tr><tr><td>String</td td><><>/td td#LOOKUP_KEY<>read-only</td td td><>Um valor opaco que contém dicas sobre como localizar o contato se sua ID de linha foi alterada como resultado de uma sincronização ou agregação.<></td></tr><tr><td>long</td><td>NAME_RAW_CONTACT_ID</td td><>read-only</td td><>the ID do contato bruto que contribui com o nome de exibição para o contato agregado. Durante a agregação, um dos contatos brutos constituintes é escolhido usando uma heurística: um nome mais longo ou um nome com marcas mais diacríticas ou mais caracteres maiúsculos é escolhido.</td></tr><tr><td>String</td><td>DISPLAY_NAME_PRIMARY</td td><>read-only</td td><td>The display name for the contact. É o nome de exibição que contribuiu com o contato bruto referenciado pela coluna NAME_RAW_CONTACT_ID.</td/tr><tr><td>long</td><><>/td td td#PHOTO_ID<>read-only</td td><td>Reference to the row in the < table holding the photo.>ContactsContract.Data Essa linha tem o tipo CommonDataKinds.Photo#CONTENT_ITEM_TYPEmime. O valor desse campo é calculado automaticamente com base no CommonDataKinds.Photo#IS_SUPER_PRIMARY campo das linhas de dados desse tipo de mime.</td></tr><td><>long</td><>#PHOTO_URI</td td td><>read-only</td td td><>A URI que pode ser usado para recuperar a foto em tamanho real do contato. Esta coluna é o método preferencial para recuperar a foto de contato.</td/tr><tr><td>long</td><><>/td td td#PHOTO_THUMBNAIL_URI<>read-only</td td><>A URI que pode ser usado para recuperar a miniatura da foto do contato.<> Esta coluna é o método preferencial para recuperar a foto de contato.</td/tr><tr><td>int</td><><>/td td td#IN_VISIBLE_GROUP<>read-only</td td><td>Um indicador de se esse contato deve estar visível na interface do usuário.<> "1" se o contato tiver pelo menos um contato bruto que pertença a um grupo visível; "0" caso contrário.</td/tr><tr><td>int</td><><>/td td td#HAS_PHONE_NUMBER<>read-only</td td><td>Um indicador de se esse contato tem pelo menos um número de telefone.<> "1" se houver pelo menos um número de telefone, "0" caso contrário.</td/tr><tr><td>int</td td><><>/td td#STARRED<>read/write</td td><td>Um indicador para contatos favoritos: '1' se favorito, '0' caso contrário.<> Quando contatos brutos são agregados, esse campo é calculado automaticamente: se algum contato bruto constituinte for estrelado, esse campo será definido como '1'. Definir esse campo altera automaticamente o campo correspondente em todos os contatos brutos constituintes.</td/tr><tr><td>String</td td><><>/td td#CUSTOM_RINGTONE<>read/write</td td td><>Um toque personalizado associado a um contato.<> Normalmente, esse é o URI retornado por uma atividade iniciada com a android.media.RingtoneManager#ACTION_RINGTONE_PICKER intenção.</td></tr><tr><td>int</td></td td>#SEND_TO_VOICEMAIL< td><>read/write</td td><td>Um indicador de se as chamadas desse contato devem ser encaminhadas diretamente para a caixa postal ('1') ou não ('0'). Quando contatos brutos são agregados, esse campo é calculado automaticamente: se todos os contatos brutos constituintes tiverem SEND_TO_VOICEMAIL=1, esse campo será definido como '1'. Definir esse campo altera automaticamente o campo correspondente em todos os contatos brutos constituintes.</td/tr><tr><td>int</td td><><>/td td#CONTACT_PRESENCE<>read-only</td td><>contact IM presence status.<> Consulte StatusUpdates as definições de status individuais. Computado automaticamente como a maior presença de todos os contatos brutos constituintes. O provedor pode optar por não armazenar esse valor no armazenamento persistente. A expectativa é que o status de presença seja atualizado regularmente.</td/tr><tr><td>String</td td><><>/td td#CONTACT_STATUS<>read-only</td td><td>Contact's latest status update.<> Computado automaticamente como o mais recente de todas as atualizações de status de contatos brutos constituintes.</td/tr><tr><td>long</td><><>/td td td#CONTACT_STATUS_TIMESTAMP<>read-only</td td><td>O tempo absoluto em milissegundos quando o status mais recente foi inserido/atualizado.<></td/tr><tr><td>String</td td><><>/td td#CONTACT_STATUS_RES_PACKAGE<>read-only</td td><td> O pacote que contém recursos para este status: rótulo e ícone.<></td/tr><tr><td>long</td><><>/td td td#CONTACT_STATUS_LABEL<>read-only</td td><td>A ID do recurso do rótulo que descreve a origem do status de contato, por exemplo, "Google Talk".<> Esse recurso tem o escopo definido pelo #CONTACT_STATUS_RES_PACKAGE.</td/tr><tr><td>long</td><><>/td td td#CONTACT_STATUS_ICON<>read-only</td td><td>The resource ID of the icon for the source of contact status.<> Esse recurso tem o escopo definido pelo #CONTACT_STATUS_RES_PACKAGE.</td></tr></table>

Java documentação para android.provider.ContactsContract.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.