<转>Android2.2 API 中文文档系列（8） —— QuickContactBadge

 

正文

　　 一、结构

　　　　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时会同时显示联系人名称）

　　四、相关文章

　　4.1      Android Quick Tip: Using the Quick Contact Badge

　　4.2       Contacts模块中的QuickContacts

　　4.3       Android自定义泡泡效果

　　　　4.4　[推荐]devoquickaction(自定义QuickContactBadge)