ContactsContract.Contacts 類別

定義

[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

繼承

Object

JavaObject

Object

ContactsContract.Contacts

屬性

RegisterAttribute

備註

聯絡人表的常數，該表包含代表同一人的原始聯絡人總量的紀錄。 <h3 操作/h3><dl><dt>b<插入></b>/dt<><dd A>聯絡人無法明確建立。<> 當輸入原始聯絡人時，提供者會先嘗試尋找代表同一人的聯絡人。 若找到，原始聯絡 RawContacts#CONTACT_ID 欄將取得該總體接觸的_ID。 若未找到匹配，提供者會自動插入新聯絡人，並將其_ID放入RawContacts#CONTACT_ID新插入的原始聯絡人欄位。</dd>dt b 更新/b</dt><>dd<只有某些接觸欄位可修改：><， >， <，>#STARRED#CUSTOM_RINGTONE#SEND_TO_VOICEMAIL 更改聯絡人中的任何這些欄位，也會改變所有組成原始聯絡人的欄位。</dd>dt b 刪除/b</dt><>dd<刪除聯絡人時要小心！><><> 刪除彙總聯絡人會刪除所有組成的原始聯絡人。 相應的同步轉接器會偵測到各自原始接點的刪除，並將其從後端儲存中移除。</dd>dt b 查詢/b</dt><>dd ul<><><li>如果你需要閱讀個別聯絡人，請考慮用 。<><>#CONTENT_LOOKUP_URI#CONTENT_URI</li><li>如果你需要用電話號碼查詢聯絡人，請使用 PhoneLookup#CONTENT_FILTER_URI PhoneLookup.CONTENT_FILTER_URI，這是為此目的優化的。</li><li>如果你需要用部分名稱查詢聯絡人，例如產生篩選建議，請使用 #CONTENT_FILTER_URI URI。 <Li>如果你需要透過電子郵件地址、暱稱等資料元素查詢聯絡人，可以用查詢表。ContactsContract.Data 結果會包含聯絡人ID、姓名等。 </ul>/dd<>/dl<>h2<欄位>/h2<>表格類別=“jd-sumtable”<>tr<>th colspan='4'Contacts<>/th<>/tr<>tr td<><long>/td<>td<>#_ID/td<>td<唯讀>/td<>td<列 ID.> 可以考慮改用#LOOKUP_KEY。</td/tr><tr td><>字串</td><td><>/td#LOOKUP_KEY<td>唯讀</td td><>不透明值，包含若列 ID 因同步或聚合而改變，該聯絡點的提示。<></td/tr><tr td><>長</td><td>NAME_RAW_CONTACT_ID</td><td 唯>讀</td><td>原始聯絡人的 ID，該聯絡人將顯示名稱貢獻給彙整聯絡人。<> 在彙整過程中，會透過啟發式方式選擇其中一個組成的原始聯絡人：選擇較長的名稱，或帶有更多變音符號或較大寫字母的名稱。</td/tr><tr td><>字串</td><td>DISPLAY_NAME_PRIMARY</td><td>唯讀</td td><>聯絡人的顯示名稱。<> 這是由NAME_RAW_CONTACT_ID欄所指的原始接觸所提供的顯示名稱。</td/tr><tr td><>長</td><td><>/td#PHOTO_ID<td>唯讀</td><td>參考顯示照片的表格中<該列。>ContactsContract.Data 那一排是默劇型 CommonDataKinds.Photo#CONTENT_ITEM_TYPE。 此欄位的值會根據CommonDataKinds.Photo#IS_SUPER_PRIMARY該 mime 類型資料列的欄位自動計算。</td/tr><tr><td>長</td><><>td#PHOTO_URI<> td-only read-only</td><>td 一個可用來擷取聯絡人全尺寸照片的 URI。<> 此欄是取得聯絡照片的首選方法。</td/tr><tr><td>長</td><td><>/td#PHOTO_THUMBNAIL_URI<td>唯讀</td td><>一個可用來擷取聯絡人照片縮圖的 URI。<> 此欄是取得聯絡照片的首選方法。</td/tr><tr><td>int</td><td><>/td#IN_VISIBLE_GROUP<td>唯讀</td><td>此聯絡人是否應該在使用者介面中顯示。<> 「1」表示接觸點至少有一個原始接觸屬於可見群;否則為<「0」。/td/tr><tr td><>int</td td><><>/td#HAS_PHONE_NUMBER<td-only>< 讀/td><td>顯示此聯絡人是否至少擁有一個電話號碼。<> 若至少有一個電話號碼，則為「1」，否則為<「0」。/td/tr><tr td><>int</td td><><>/td#STARRED<td>讀/寫</td td><>一個最愛聯絡人的指示器：最愛為「1」，否則為「0」。<> 當原始接觸被彙總時，此欄位會自動計算：若任何原始聯絡人被星標記，則此欄位設為「1」。 設定此欄位會自動改變所有原始接觸的對應欄位。</td/tr><tr td><>字串</td><td><>/td#CUSTOM_RINGTONE<td>讀/寫</td td><>與接點相關的自訂鈴聲。<> 通常是由以意圖android.media.RingtoneManager#ACTION_RINGTONE_PICKER啟動的活動回傳的 URI。</td/tr><tr><td>int</td><td><>/td#SEND_TO_VOICEMAIL<td>read/write</td td><>是判斷該聯絡人來電是否應該直接轉接到語音信箱（'1'）或是否（'0'）的指示。<> 當原始接觸被彙總時，此欄位會自動計算：若 所有 組成原始接觸皆為 SEND_TO_VOICEMAIL=1，則該欄位設為 '1'。 設定此欄位會自動改變所有原始接觸的對應欄位。</td/tr><tr><td>int</td><td><>/td#CONTACT_PRESENCE<td>唯讀</td><td>聯絡即時通訊狀態。<> 請參閱 StatusUpdates 個別身份定義。 自動計算為所有原始接觸中存在度最高的值。 提供者可選擇不將此值儲存在持久儲存中。 預期存在狀態會定期更新。</td/tr><tr><td>字串</td><td><>/td#CONTACT_STATUS<td>唯讀</td td><>聯絡人最新狀態更新。<> 自動計算為所有原始聯絡人狀態更新中的最新一次。</td/tr><tr><td>long</td><td><>/td#CONTACT_STATUS_TIMESTAMP<td>唯讀/td<>< td>最新狀態插入/更新的絕對時間（毫秒）。<></td/tr><tr td><>字串</td><td><>/td#CONTACT_STATUS_RES_PACKAGE<td>唯讀</td td><> 包含此狀態資源的套件：label 和 icon。<></td/tr><tr td><>長</td><td><>/td#CONTACT_STATUS_LABEL<td>唯讀</td><td>標籤的資源 ID，描述聯絡狀態來源，例如「Google Talk」。<> 此資源由 #CONTACT_STATUS_RES_PACKAGE< 。/td/tr><tr td><>長</td><td><>/td#CONTACT_STATUS_ICON<td>唯讀</td><td>是聯絡狀態來源圖示的資源 ID。<> 此資源由 #CONTACT_STATUS_RES_PACKAGE< 。/td></tr></table>

的 android.provider.ContactsContract.ContactsJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。