android 2.2 api8,Android2.2 API 中文文档系列（8） —— QuickContactBadge

前言

本章翻译的是android.widget.QuickContactBadge，译为联系人快捷标识，具体效果为显示一张联系人图片，点一下弹出与之相关的快捷功能栏，如打电话、发短信等(见正文部分的截图)。欢迎更多译者一起参与Android API 的中文翻译行动!我的邮箱over140@gmail.com。

声明

欢迎转载，但请保留文章原始出处:)

正文

一、结构

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.4　[推荐]devoquickaction(自定义QuickContactBadge)

五、 下载

六、系列

结束

类概述这块的翻译在文章里去掉了，感觉翻译得非常不通顺(PDF版本里有保留)，待请教别人之后再补上。相关文章中的几篇文章都非常不错，想深入了解的朋友可以看下这几篇文章。