一、结构
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时会同时显示联系人名称)
使用QuickContactBadge并不需要加入READ_CONTACTS权限。但是在无权限的情况下,如果联系人在通讯录里,则会直接进入查看联系人的界面,而不会有“拨打、查看、短信”三个选项。加入权限后则会出现。
Android: 弹出快捷联系人操作对话框
题目所说的快捷操作对话框在android的很多地方都有,例如点击短信条目中联系人头像,就会弹出三个操作选项:电话、查看、短信。要实现这样的操作,主要是通过QuickContactBadge这个view。
关于这个类的使用,网上资料很少。开始我走了一个弯路,以为这个类是负责那个对话框的。其实不是,这个类只是一个普通的图片view,点击它就会弹出这里所说的对话框。
XML文件:
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:paddingLeft="0dip"
android:paddingRight="9dip"
android:layout_height= "wrap_content"
android:minHeight="48dip">
<QuickContactBadge
android:id="@+id/photo"
android:layout_width="54dip"
android:layout_height="57dip"
android:layout_marginLeft="5dip"
android:background="#ffffff"
style="?android:attr/quickContactBadgeStyleWindowSmall" />
</RelativeLayout>
代码!!
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import android.app.Activity;
import android.os.Bundle;
import android.provider.ContactsContract.QuickContact;
import android.view.View;
import android.widget.AdapterView;
import android.widget.AdapterView.OnItemClickListener;
import android.widget.ListView;
import android.widget.QuickContactBadge;
public class MyQuickContactBadgeActivity extends Activity {
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
QuickContactBadge mPhotoView;
mPhotoView = (QuickContactBadge) findViewById(R.id.photo);
mPhotoView.assignContactFromPhone("1899847822", true);
mPhotoView.setMode(QuickContact.MODE_SMALL);
}
}
运行的初始画面:
点击上面的白色按钮进入下面界面
打电话显示的界面