一、结构
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.3 Android自定义泡泡效果
4.4 [推荐]devoquickaction(自定义QuickContactBadge)
五、 下载
PDF:http://download.csdn.net/source/2723177
事例代码:/Files/over140/2010/9/Android2.2Test.rar
六、系列
Android2.2 API 中文文档系列(1) —— TextView
Android2.2 API 中文文档系列(2) —— EditText
Android2.2 API 中文文档系列(3) —— AccessibilityService
Android2.2 API 中文文档系列(4) —— Manifest
Android2.2 API 中文文档系列(5) —— View
Android2.2 API 中文文档系列(6) —— ImageView
Android2.2 API 中文文档系列(7) —— ImageButton
本文转自博客园农民伯伯的博客,原文链接:Android2.2 API 中文文档系列(8) —— QuickContactBadge,如需转载请自行联系原博主。