life02
  C++博客 :: 首页 :: 新随笔 :: 联系 :: 聚合  :: 管理 ::
  197 随笔 :: 3 文章 :: 37 评论 :: 0 Trackbacks
Android 通讯录选择联系人

引言

http://www.oschina.net/question/54100_28547
http://www.apkbus.com/android-18748-1-1.html

上篇我们介绍了Intents和Intent Filters的理论部分，主要是介绍了：activities、services、broadcastreceivers三种组件的Intent机制两种Intent（显式和隐式）及它们如何去匹配目的组件、Intent对象包含哪些信息、Intent Filters的action & category & data。

Intent的重要性，我不再着重介绍了，但我还是要说：Intent能够使应用程序突破沙盒与外界交流，者这使得Android的世界变得丰富多彩！本篇将用实例来介绍，如何应用Intent，而且继续用SMS方面的例子来阐述。本文的主要内容如下：

  • 例子（需求）描述
  • STEP1、添加用于显示通讯录的布局文件
  • STEP2、添加Button的点击事件
  • STEP3、添加通讯录活动
  • STEP4、解析通讯录返回的数据
  • STEP5、在清单文件AndroidManifest.xml中注册通讯录活动和读取Contact数据库的权限
  • 总结

例子（需求）描述

用手机发过SMS的人都知道：

  • 用户可以先编辑短信，然后再去通讯录中选择相应的人并发生给他。
  • 用户可以在短信内容中插入通讯录中联系人的号码。

我们的这个例子就是要说明如何实现这个功能。要实现这个功能，即是创建一个新的Activity选择（ACTION_PICK）通讯录中的数据，它会显示通讯录中的所有联系人并让用户选择，然后关闭并返回一个联系人的URI给短信程序。下面介绍如何一步一步实现类似的功能，而且是在之前Android 开发之旅：短信的收发及在android模拟器之间实践（一）中发送SMS的例子（TextMessage）基础上加上从通讯录中选择联系人的功能。

STEP1、添加用于显示通讯录的布局文件

我们用一个ListView来显示整个通讯录，其中用TextView显示每一记录。它们的xml文件分别为contact.xml、listitemlayout，如下所示：

====================================contact.xml

view source
print?
01 <?xmlversion="1.0"encoding="utf-8"?>
02   
03 <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"
04   
05 android:orientation="vertical"
06   
07 android:layout_width="fill_parent"
08   
09 android:layout_height="fill_parent"
10   
11 >
12   
13 <ListViewandroid:id="@+id/contactListView"
14   
15 android:layout_width="fill_parent"
16   
17 android:layout_height="wrap_content"
18   
19 />
20   
21 </LinearLayout>

=================================== listitemlayout

view source
print?
01 <?xmlversion="1.0"encoding="utf-8"?>
02   
03 <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android"
04   
05 android:orientation="vertical"android:layout_width="fill_parent"
06   
07 android:layout_height="fill_parent">
08   
09 <TextViewandroid:id="@+id/itemTextView"android:layout_width="wrap_content"
10   
11 android:layout_height="wrap_content"android:padding="10px"
12   
13 android:textSize="16px"android:textColor="#FFF" />
14   
15 </LinearLayout>

 

为了能够打开通讯录，我们还需要在TextMessage程序中加入一个Button btnContact，通过点击btnContact激活显示通讯录的活动。这只需在main.xml文件中加入如下代码：

view source
print?
1 <Buttonandroid:layout_width="wrap_content"
2         android:layout_height="wrap_content"
3         android:text="@string/btnContact"
4         android:id="@+id/btnContact"    />

记得还有在values/strings.xml中相应的加入<stringname="btnContact">contact</string>。

STEP2、添加Button的点击事件

在上面准备工作做完之后，我们需要监听btnContact的点击事件，当用户点击btnContact时，跳转显示通讯录界面，当用户选择一个联系人之后，返回SMS程序的主界面。这里就要用到了伟大的Intent啦！

view source
print?
01 btnContact = (Button) findViewById(R.id.btnContact);
02   
03 btnContact.setOnClickListener(new View.OnClickListener() {
04   
05 @Override
06   
07 publicvoid onClick(View v) {
08   
09 // TODO Auto-generated method stub
10   
11 Intent intent = new Intent(Intent.ACTION_PICK,
12   
13 ContactsContract.Contacts.CONTENT_URI);
14   
15 startActivityForResult(intent, PICK_CONTACT);
16   
17 }
18   
19   
20 });

 

STEP3、添加通讯录活动

添加一个类文件，类名为ContactPick（表示通讯录活动名）继承Activity。它的主要功能就是获取从SMS主程序传递来的Intent并提取数据；然后去查询通讯录数据库，取出数据并填充到STEP1中定义的ListView；最后，还需要添加当用户选择一个联系人的事件onItemClick，将结果返回给SMS主程序，这里也用到了我们伟大的Intent啦！代码如下：

view source
print?
01 package skynet.com.cnblogs.www;
02   
03   
04 import android.app.Activity;
05   
06 import android.content.Intent;
07   
08 import android.database.Cursor;
09   
10 import android.net.Uri;
11   
12 import android.os.Bundle;
13   
14 import android.provider.ContactsContract;
15   
16 import android.view.View;
17   
18 import android.widget.AdapterView;
19   
20 import android.widget.ListView;
21   
22 importandroid.widget.SimpleCursorAdapter;
23   
24 import android.widget.AdapterView.OnItemClickListener;
25   
26   
27 publicclass ContactPick extends Activity {
28   
29 /** Called when the activity is first created. */
30   
31 @Override
32   
33 publicvoid onCreate(Bundle savedInstanceState) {
34   
35 super.onCreate(savedInstanceState);
36   
37 setContentView(R.layout.main);
38   
39   
40 Intent orgIntent=getIntent();
41   
42 Uri queryUri=orgIntent.getData(); 
43   
44 final Cursor c = managedQuery(queryUri,
45   
46 null, 
47   
48 null,
49   
50 null,
51   
52 null);
53   
54   
55 String[] fromColumns=new String[]{ContactsContract.Contacts.DISPLAY_NAME};
56   
57 int[] toLayoutIDs = newint[] { R.id.itemTextView };
58   
59 SimpleCursorAdapter adapter = newSimpleCursorAdapter(this,
60   
61 R.layout.listitemlayout, c, fromColumns, toLayoutIDs);
62   
63 ListView lv = (ListView) findViewById(R.id.contactListView);
64   
65 lv.setAdapter(adapter);
66   
67 lv.setOnItemClickListener(new OnItemClickListener() {
68   
69 @Override
70   
71 publicvoid onItemClick(AdapterView<?> parent, View view, int pos,
72   
73 long id) {
74   
75 c.moveToPosition(pos); 
76   
77 int rowId = c.getInt(c.getColumnIndexOrThrow(ContactsContract.Contacts._ID));
78   
79 Uri outURI = Uri.parse(ContactsContract.Contacts.CONTENT_URI.toString() + rowId);
80   
81 Intent outData = new Intent();
82   
83 outData.setData(outURI);
84   
85 setResult(Activity.RESULT_OK,outData);
86   
87 finish();
88   
89 }
90   
91 });
92   
93 }
94   
95 }

 

STEP4、解析通讯录返回的数据

从通讯录活动返回之后，我们从返回的Intent中提取数据并填充到填写电话号码的EditView中。代码主要如下：

view source
print?
01 @Override
02 publicvoid onActivityResult(int reqCode, int resCode, Intent data) {
03   
04 super.onActivityResult(reqCode, resCode, data);
05   
06   
07 switch (reqCode) {
08   
09 case (PICK_CONTACT): {
10   
11 if (resCode == Activity.RESULT_OK) {
12   
13 String name; 
14   
15 Uri contactData = data.getData();
16   
17 Cursor c = managedQuery(contactData, null, null, null, null);
18   
19 c.moveToFirst();
20   
21 name = c.getString(c.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
22   
23 TextView tv;
24   
25 tv = (TextView)findViewById(R.id.edtPhoneNo);
26   
27 tv.setText(name);
28   
29 }
30   
31 break;
32   
33 }
34   
35 }
36   
37 }

STEP5、在清单文件AndroidManifest.xml中注册通讯录活动和读取Contact数据库的权限

主要工作基本做完了，现在我们只需要注册通讯录活动和读取Contact数据的权限了。完整的清单文件代码如下：

view source
print?
01 <?xmlversion="1.0"encoding="utf-8"?>
02 <manifestxmlns:android="http://schemas.android.com/apk/res/android"
03 package="skynet.com.cnblogs.www"android:versionCode="1"
04 android:versionName="1.0">
05   
06 <application>
07   
08 <activityandroid:name=".TextMessage"android:label="@string/app_name">
09   
10 <intent-filter>
11   
12 <actionandroid:name="android.intent.action.MAIN"/>
13 <categoryandroid:name="android.intent.category.LAUNCHER"/>
14   
15 </intent-filter>
16   
17 </activity>
18   
19 <activityandroid:name=".ContactPick"android:label="@string/app_name">
20 <actionandroid:name="android.intent.action.PICK"/>
21 <categoryandroid:name="android.intent.category.DEFAULT"/>
22   
23 </activity>
24   
25 </application>
26   
27 <uses-permissionandroid:name="android.permission.SEND_SMS"/>
28 <uses-permissionandroid:name="android.permission.READ_CONTACTS"/>
29   
30 </manifest>

注意通讯录活动的Intent Filters，它的 action是 android.intent.action.PICK； category是 android.intent.category.DEFAULT。现在我们分析一下这个Intent Filter：

  • <actionandroid:name="android.intent.action.PICK"/>：使用户能够可以在通讯录列表中选择一个，然后将选择的联系人的 URL返回给调用者。
  • <categoryandroid:name="android.intent.category.DEFAULT"/>：这是默认的category，如果不知道category系统会自动加上。这个属性是让使其能够被像Context.startActivity()等找到。要说明的的是，如果列举了多个category，这个活动仅会去处理那些Intent中都包含了所有列举的category的组件。

我们还可以在清单文件中看到TextMessage活动的Intent Filter：

view source
print?
1 <intent-filter>
2     <actionandroid:name="android.intent.action.MAIN"/>
3     <categoryandroid:name="android.intent.category.LAUNCHER"/>
4 </intent-filter>

它指 TextMessage活动定是真个程序的入口并且 TextMessage会列举在Launcher即启动列表中。

程序运行结果如下图所示：

图1、主界面

图2、点击contact按钮之后

图3、选择一个联系人之后

总结

我们用发短信中选择联系人的例子说明Intent和Intent Filter，这里体现了两个活动之间如何通过Intent和Intent Filter来交互，这也是我们在编写Android应用程序的时候经常遇到了。本文除了上述的主要内容之外，还涉及别的知识点，下面列举几个个人认为比较有用的知识点：

  • Cursor类它跟我们平时用的数据库中的游标类似，它提供了对从数据库返回的结果的随机读写操作。如我们例子中用到的，通过 managedQuery方法 查询数据库并返回结果，然后利用 Cursor对它进行操作。下面介绍 Cursor类的几个方法（我们例子中用到的，更多的方法请自行查阅相关资料）：
    • public abstract int getColumnIndexOrThrow (String columnName)：返回给定列名的索引（注意：从0开始的），或者当列名不存在时抛出llegalArgumentException异常；
    • public abstract boolean moveToFirst ()：移动到第一行。如果Cursor为空，则返回FALSE
    • public abstract boolean moveToPosition (int position)：将游标移动到一个指定的位置，它的范围在-1 <= position <= count。如果position位置不可达，返回FALSE
  • managedQuery方法：根据指定的URI路径信息返回包含特定数据的Cursor对象，应用这个方法可以使Activity接管返回数据对象的生命周期。参数：
    URI: Content Provider 需要返回的资源索引
    Projection: 用于标识有哪些columns需要包含在返回数据中
    Selection: 作为查询符合条件的过滤参数，类似于SQL语句中Where之后的条件判断
    SelectionArgs: 同上
    SortOrder: 用于对返回信息进行排序
  • SimpleCursorAdapter允许你绑定一个游标的列到ListView上，并使用自定义的layout显示每个项目。SimpleCursorAdapter的创建，需要传入当前的上下文、一个layout资源，一个游标和两个数组：一个包含使用的列的名字，另一个（相同大小）数组包含View中的资源ID，用于显示相应列的数据值。
posted on 2011-12-22 09:11 life02 阅读(2124) 评论(0)  编辑 收藏 引用 所属分类: Android开发

只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   博问   Chat2DB   管理