Android2.2 API 中文文檔系列（8） —— QuickContactBadge

前言
 

　　 本章翻譯的是android.widget.QuickContactBadge，譯為聯系人快捷標識，具體效果為顯示一張聯系人圖片，點一下彈出與之相關的快捷功能欄，如打電話、發短信等（見正文部分的截圖）。歡迎更多譯者一起參與Android API 的中文翻譯行動!我的郵箱[email protected]。
 

聲明

　　歡迎轉載，但請保留文章原始出處:)
 

　　　　博客園：http://www.cnblogs.com

　　　　農民伯伯： http://www.cnblogs.com/over140/ 

正文

　　 一、結構
 

　　　　java.lang.Object
   　　　　↳     android.view.View
         　　　　↳     android.widget.ImageView
               　　　　↳     android.widget.QuickContactBadge 

　　二、截圖

　　　　說明：在andorid自帶的ApiDomos的例子中有這個的代碼：App/Activity/QuickContacktsDemo。注意需要android.permission.READ_CONTACTS權限，並且聯系人裡面有數據，並且聯系人需要有手機號碼，不然出來是一個空的（看代碼可知）。

　　三、公共方法

         public void assignContactFromEmail (String emailAddress, boolean lazyLookup)

 指定聯系人的電子郵箱地址。（注：它會先搜索這個號碼，如果沒有會提醒你是否添加到聯系人，參見文章1）      

　　　　參數

　　　　　　emailAddress          聯系人的電子郵箱地址

　　　　　　lazyLookup      如果設置為true，將不會立即查找這個郵箱地址，直到View被點擊時。（注：是否延遲匹配電子郵件）

         public void assignContactFromPhone (String phoneNumber, boolean lazyLookup)

         為聯系人指定一個電話號碼。（注：參見文章1）

　　　 　　參數

              　　phoneNumber  聯系人的電話號碼

               　  lazyLookup     如果設置為true，將不會立即查找這個電話號碼，直到View被點擊時。

         public void assignContactUri (Uri contactUri)

         指定和QuickContactBadge關聯的聯系人URI。注意，這裡只是顯示QuickContact窗口，並不為你綁定聯系人圖片。

         　　參數

              　　contactUri       CONTENT_URI或CONTENT_LOOKUP_URI其中一種風格的URI.

         public void onClick (View v)

         當View被點擊時調用。

         　　參數

              　　v      被點擊的View.

         public void setExcludeMimes (String[] excludeMimes)

         設置一組要排除不顯示的MIMI類型列表。例如，可以隱藏Contacts.CONTENT_ITEM_TYPE類型的圖標。（注：如果像如下設置：

　　setExcludeMimes(new String[] { Contacts.CONTENT_ITEM_TYPE })

　　即隱藏了上面截圖的第二個，僅顯示電話和短信兩個圖標）

         public void setMode (int size)

       設置QuickContact的窗口模式。如下選項：MODE_SMALL、MODE_MEDIUM、MODE_LARGE。（注：默認為QuickContact.MODE_MEDIUM，設置為MODE_LARGE時會同時顯示聯系人名稱）

　　四、 下載
 

　　　　　事例代碼Android2.2Test.rar

轉自：http://www.cnblogs.com/over140/archive/2010/09/28/1837287.html