ContactsContract.Contacts Classe

Définition

[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

Héritage

Object

JavaObject

Object

ContactsContract.Contacts

Attributs

RegisterAttribute

Remarques

Constantes pour la table de contacts, qui contient un enregistrement par agrégat de contacts bruts représentant la même personne. <h3>Operations</h3><dl dt><><b>Insert</b></dt dd><>A Contact ne peut pas être créé explicitement. Lorsqu’un contact brut est inséré, le fournisseur essaie d’abord de trouver un contact représentant la même personne. Si l’un d’eux est trouvé, la colonne du RawContacts#CONTACT_ID contact brut obtient la _ID du contact agrégé. Si aucune correspondance n’est trouvée, le fournisseur insère automatiquement un nouveau contact et place son _ID dans la RawContacts#CONTACT_ID colonne du contact brut nouvellement inséré.</dd><dt><b>Update</b></dt dt><dd>uniquement certaines colonnes de Contact sont modifiables : #STARRED, , #CUSTOM_RINGTONE#SEND_TO_VOICEMAIL. La modification de ces colonnes sur le contact les modifie également sur tous les contacts bruts constituants.</dd><dt><b>Delete</b></dt dt><dd dd>Soyez prudent avec la suppression des contacts ! La suppression d’un contact agrégé supprime tous les contacts bruts constituants. Les adaptateurs de synchronisation correspondants notent les suppressions de leurs contacts bruts respectifs et les suppriment de leur stockage principal.</dd><dt><b>Query</b></dt dt><dd><ul><li>Si vous avez besoin de lire un contact individuel, envisagez d’utiliser #CONTENT_LOOKUP_URI au lieu de #CONTENT_URI.</li li><>Si vous avez besoin de rechercher un contact par le numéro de téléphone, utilisez PhoneLookup#CONTENT_FILTER_URI PhoneLookup.CONTENT_FILTER_URI, qui est optimisé à cet effet.</li li><>Si vous devez rechercher un contact par nom partiel, par exemple pour produire des suggestions de filtre en tant que type, utilisez l’URI.#CONTENT_FILTER_URI <li>If you need to look up a contact by some data element like email address, surnom, etc, use a query against the ContactsContract.Data table. Le résultat contient l’ID de contact, le nom, etc. </ul>/dd<>/dl<>h2<Columns>/h2<>table class="jd-sumtable"<>tr<>th colspan='4'Contacts<>/th<>/tr tr<>tr<>td<long>/td td td/<><td>#_ID<><read-only>/td td<><Row ID.> Envisagez plutôt d’utiliser#LOOKUP_KEY.</td></tr tr><><td>String</td td><td>#LOOKUP_KEY<><> en lecture seule</td td><td>Une valeur opaque qui contient des conseils sur la façon de trouver le contact si son ID de ligne a changé en raison d’une synchronisation ou d’une agrégation.</td>/tr tr<>tr<>td<long>/td<><NAME_RAW_CONTACT_ID>/td td<><read-only>/td td<><Td L’ID du contact brut qui contribue au nom complet au contact agrégé.> Pendant l’agrégation, l’un des contacts bruts constituants est choisi à l’aide d’une heuristique : un nom plus long ou un nom avec plus de marques diacritiques ou plus de caractères majuscules est choisi.</td>/tr tr<><>td<String>/td<><DISPLAY_NAME_PRIMARY>/td td<><read-only>/td td td<><Le nom complet du contact.> Il s’agit du nom complet fourni par le contact brut référencé par la colonne NAME_RAW_CONTACT_ID.</td>/tr tr<><>td<long>/td<>td<>#PHOTO_ID/td<><read-only>/td<><Reference to the row in the > table holding the photo.ContactsContract.Data Cette ligne a le type CommonDataKinds.Photo#CONTENT_ITEM_TYPEmime . La valeur de ce champ est calculée automatiquement en fonction du CommonDataKinds.Photo#IS_SUPER_PRIMARY champ des lignes de données de ce type mime.</td>/tr tr<><>tr td<long>/td<>td<>#PHOTO_URI/td<><td read-only>/td A<><URI qui peut être utilisé pour récupérer la photo pleine taille du contact.> Cette colonne est la méthode préférée de récupération de la photo de contact.</td>/tr tr<><>tr td<long>/td td<><>#PHOTO_THUMBNAIL_URI/td<><td read-only>/td td<><A URI qui peut être utilisé pour récupérer la miniature de la photo du contact.> Cette colonne est la méthode préférée de récupération de la photo de contact.</td></tr tr><tr><td>int</td><>td#IN_VISIBLE_GROUP<td><> read-only</td td td><>Un indicateur indiquant si ce contact est censé être visible dans l’interface utilisateur. « 1 » si le contact a au moins un contact brut appartenant à un groupe visible ; « 0 » sinon.</td></tr tr><tr><td>int</td td><td>#HAS_PHONE_NUMBER< en lecture seule>/td<><td><Td>Un indicateur indiquant si ce contact a au moins un numéro de téléphone. « 1 » s’il y a au moins un numéro de téléphone, « 0 » sinon.</td></tr tr><><td>int</td><>td#STARRED<td><> read/write</td td><>Td Un indicateur pour les contacts favoris : « 1 » si favori, « 0 » sinon. Lorsque les contacts bruts sont agrégés, ce champ est automatiquement calculé : si des contacts bruts constituants sont en vedette, ce champ est défini sur « 1 ». La définition de ce champ modifie automatiquement le champ correspondant sur tous les contacts bruts constituants.</td>/tr tr<><>td<String>/td td<><>#CUSTOM_RINGTONE/td td<><read/write>/td<><A sonnerie personnalisée associée à un contact.> En règle générale, il s’agit de l’URI retourné par une activité lancée avec l’intentionandroid.media.RingtoneManager#ACTION_RINGTONE_PICKER.</td>/tr tr<><>tr td<int>/td<><>#SEND_TO_VOICEMAILtd td<>< read/write>/td td<>Td<Un indicateur indiquant si les appels de ce contact doivent être transférés directement vers la messagerie vocale ('1') ou non ('0').> Lorsque les contacts bruts sont agrégés, ce champ est automatiquement calculé : si tous les contacts bruts constituants ont SEND_TO_VOICEMAIL=1, ce champ est défini sur « 1 ». La définition de ce champ modifie automatiquement le champ correspondant sur tous les contacts bruts constituants.</td>/tr tr<><>td<int>/td td<></td>#CONTACT_PRESENCE<><td read-only>/td<><contact im presence status.> Consultez StatusUpdates les définitions d’état individuelles. Calculé automatiquement comme la présence la plus élevée de tous les contacts bruts constituants. Le fournisseur peut choisir de ne pas stocker cette valeur dans le stockage persistant. L’attente est que l’état de présence sera mis à jour régulièrement.</td>/tr tr<><>td<String>/td td<>/td td<>#CONTACT_STATUS<>< read-only>/td td<>td<contact’s dernière mise à jour d’état.> Calculé automatiquement comme la dernière version de toutes les mises à jour d’état des contacts bruts constituants.</td>/tr<><>td<long>/td<>td<>#CONTACT_STATUS_TIMESTAMP/td<><read-only>/td td td<><Temps absolu en millisecondes lorsque l’état le plus récent a été inséré/mis à jour.></td>/tr tr<><>td<String>/td td<><>#CONTACT_STATUS_RES_PACKAGE/td<><td read-only>/td<>< Le package contenant des ressources pour cet état : étiquette et icône.></td>/tr tr<><>tr td<long>/td<><>#CONTACT_STATUS_LABELtd td<>< read-only>/td td td<><L’ID de ressource de l’étiquette décrivant la source de l’état du contact, par exemple « Google Talk ».> Cette ressource est limitée par le #CONTACT_STATUS_RES_PACKAGE.</td>/tr tr<><>td<> long/td<><>#CONTACT_STATUS_ICON td/td<><td read-only>/td td td<><L’ID de ressource de l’icône pour la source de l’état du contact.> Cette ressource est limitée par le #CONTACT_STATUS_RES_PACKAGE.</td></tr></table>

Java documentation pour android.provider.ContactsContract.Contacts.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.