ContactsContract.Contacts Clase

Definición

[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

Herencia

Object

JavaObject

Object

ContactsContract.Contacts

Atributos

RegisterAttribute

Comentarios

Constantes de la tabla de contactos, que contiene un registro por agregado de contactos sin procesar que representa a la misma persona. <h3>Operations</h3><dl><dt><b>Insert</b></dt><dd>A Contact no se puede crear explícitamente. Cuando se inserta un contacto sin procesar, el proveedor intentará buscar primero un contacto que represente a la misma persona. Si se encuentra uno, la columna del RawContacts#CONTACT_ID contacto sin procesar obtiene el _ID del contacto agregado. Si no se encuentra ninguna coincidencia, el proveedor inserta automáticamente un nuevo contacto y coloca su _ID en la RawContacts#CONTACT_ID columna del contacto sin procesar recién insertado.</dd><dt><b>Update</b></dt><dd>Solo se pueden modificar determinadas columnas de Contacto: #STARRED, #CUSTOM_RINGTONE, #SEND_TO_VOICEMAIL. Cambiar cualquiera de estas columnas en el contacto también las cambia en todos los contactos sin procesar constituyentes.</dd><dt><b>Delete</b></dt><dd>Tenga cuidado con la eliminación de contactos! Al eliminar un contacto agregado, se eliminan todos los contactos sin procesar constituyentes. Los adaptadores de sincronización correspondientes observarán las eliminaciones de sus respectivos contactos sin procesar y las quitarán de su almacenamiento back-end.</dd><dt><b>Query</b></dt><dd><ul><li>Si necesita leer un contacto individual, considere la posibilidad de usar #CONTENT_LOOKUP_URI en lugar de #CONTENT_URI.</li li><>Si necesita buscar un contacto por el número de teléfono, use PhoneLookup#CONTENT_FILTER_URI PhoneLookup.CONTENT_FILTER_URI, que está optimizado para este propósito.</li li><>Si necesita buscar un contacto por nombre parcial, por ejemplo, para generar sugerencias de filtro como tipo, use el #CONTENT_FILTER_URI URI. <li>Si necesita buscar un contacto por parte de algún elemento de datos como la dirección de correo electrónico, el alias, etc., use una consulta en la ContactsContract.Data tabla. El resultado contendrá el identificador de contacto, el nombre, 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<>td<read-only>/td td<><row ID.> Considere la posibilidad de usar #LOOKUP_KEY en su lugar.</td/tr tr><td><>String</td><td td><> td td#LOOKUP_KEY<>read-only</td td><>Un valor opaco que contiene sugerencias sobre cómo encontrar el contacto si su identificador de fila ha cambiado como resultado de una sincronización o agregación.<></td></tr tr><td><>long</td td td><>NAME_RAW_CONTACT_ID</td td><>de solo< lectura/td td td><>Id. del contacto sin formato que contribuye al nombre para mostrar al contacto agregado. Durante la agregación se elige uno de los contactos sin procesar constituyentes mediante una heurística: se elige un nombre más largo o un nombre con más marcas diacríticas o más caracteres en mayúsculas.</td></tr tr><td><>String</td td><>DISPLAY_NAME_PRIMARY</td td><>read-only</td td td><>El nombre para mostrar del contacto. Es el nombre para mostrar aportado por el contacto sin procesar al que hace referencia la columna NAME_RAW_CONTACT_ID.</td></tr tr><tr td><>long</td><td td>#PHOTO_ID< td td><>read-only</td td><>Referencia a la fila de la ContactsContract.Data tabla que contiene la foto. Esa fila tiene el tipo CommonDataKinds.Photo#CONTENT_ITEM_TYPEmime . El valor de este campo se calcula automáticamente en función del CommonDataKinds.Photo#IS_SUPER_PRIMARY campo de las filas de datos de ese tipo mime.</td></tr tr><td><>long</td><td td td>#PHOTO_URI< td><>read-only</td td><>A URI que se puede usar para recuperar la foto de tamaño completo del contacto. Esta columna es el método preferido para recuperar la foto de contacto.</td></tr tr><td><>long</td td><td td>#PHOTO_THUMBNAIL_URI< td><>read-only</td td><>URI A que se puede usar para recuperar la miniatura de la foto del contacto. Esta columna es el método preferido para recuperar la foto de contacto.</td></tr tr><td><>int</td td><td td>#IN_VISIBLE_GROUP< td><>read-only</td td><>Indicador de si este contacto se supone que es visible en la interfaz de usuario. "1" si el contacto tiene al menos un contacto sin procesar que pertenece a un grupo visible; En caso contrario, "0".</td/tr tr><td><>int</td><td td><> td td#HAS_PHONE_NUMBER<>read-only</td td><>Indica si este contacto tiene al menos un número de teléfono.<> "1" si hay al menos un número de teléfono, "0" de lo contrario.</td></tr tr><tr><td>int</td><td td td>#STARRED<><> read/write</td td><>Indicador de contactos favoritos: '1' si favorito, '0' de lo contrario. Cuando se agregan contactos sin procesar, este campo se calcula automáticamente: si se estrellan contactos sin procesar constituyentes, este campo se establece en "1". Al establecer este campo, se cambia automáticamente el campo correspondiente en todos los contactos sin procesar constituyentes.</td></tr tr td><><>String</td><td td>#CUSTOM_RINGTONE< td td><>read/write</td td><>A tono personalizado asociado a un contacto. Normalmente, este es el URI devuelto por una actividad iniciada con la android.media.RingtoneManager#ACTION_RINGTONE_PICKER intención.</td></tr tr><><td>int</td><td td>#SEND_TO_VOICEMAIL<td><> read/write</td td><>Indicador de si las llamadas de este contacto deben reenviarse directamente al correo de voz ('1') o no ('0'). Cuando se agregan contactos sin procesar, este campo se calcula automáticamente: si todos los contactos sin procesar constituyentes tienen SEND_TO_VOICEMAIL=1, este campo se establece en "1". Al establecer este campo, se cambia automáticamente el campo correspondiente en todos los contactos sin procesar constituyentes.</td></tr tr tr><><td>int</td><td td>#CONTACT_PRESENCE< td td><>read-only</td td><>Estado de presencia de mi contacto. Consulte StatusUpdates para obtener definiciones de estado individuales. Calculado automáticamente como la mayor presencia de todos los contactos sin procesar constituyentes. El proveedor puede optar por no almacenar este valor en el almacenamiento persistente. La expectativa es que el estado de presencia se actualice periódicamente.</td></tr tr><td><>String</td><td td td>#CONTACT_STATUS< td><>read-only</td td td><>Contact's latest status update. Se calcula automáticamente como la última de todas las actualizaciones de estado de todos los contactos sin procesar constituyentes.</td></tr tr><td><>long</td td><td>#CONTACT_STATUS_TIMESTAMP< td td><>read-only</td td td><>El tiempo absoluto en milisegundos cuando se insertó o actualizó el estado más reciente.</td/tr tr><td><>String</td><td td><> td td#CONTACT_STATUS_RES_PACKAGE<>read-only</td td td><> El paquete que contiene recursos para este estado: etiqueta e icono.<></td></tr tr><td><>long</td td><td>#CONTACT_STATUS_LABEL< td td><>read-only</td td><>El identificador de recurso de la etiqueta que describe el origen del estado de contacto, por ejemplo, "Google Talk". El ámbito #CONTACT_STATUS_RES_PACKAGEde este recurso es .</td></tr tr><td><>long</td td><td>#CONTACT_STATUS_ICON< td td><>read-only</td td td><>El identificador de recurso del icono para el origen del estado de contacto. El ámbito #CONTACT_STATUS_RES_PACKAGEde este recurso es .</td></tr></table>

Java documentación para android.provider.ContactsContract.Contacts.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.