通过这篇文章，我想说明一下如何创建一个可搜索的“联系人列表”Android应用程序。使用这个应用程序，用户可以通过使用导航按钮浏览所有保存的联系人和根据联系人名称搜索联系人。该应用程序还可以显示联系人的照片（如果可用）。
要浏览联系人列表可以使用<<，<，>和>>按钮。
要搜索联系人的用户在“搜索名称”文本框中键入联系人名称，然后单击“搜索”按钮。点击“清除搜索”按钮，清除“搜索名称”文本框中，并显示开始搜索前，最后一次查看的联系人。
由于该应用从设备读取联系人，以下条目需要在AndroidManifest.xml文件，以允许权限应用读取联系人：
<uses-permission android:name="android.permission.READ_CONTACTS"/>
下面的代码创建一个表格布局显示联系人：
<TableLayout
xmlns:android="<a href="http://schemas.android.com/apk/res/android"" rel="nofollow">http://schemas.android.com/apk/res/android"</a>
android:layout_height="match_parent"
android:layout_width="350dp">
<TableRow>
<TextView android:id="@+id/txtId"
android:width="175dp"
android:text="Contact Id: "/>
<TextView android:id="@+id/txtIdVal"
android:width="175dp"/>
</TableRow>
<TableRow>
<TextView android:id="@+id/txtDisplayName"
android:width="175dp"
android:text="Contact Name: "/>
<TextView android:id="@+id/txtDisplayNameVal"
android:width="175dp"/>
</TableRow>
<TableRow>
<TextView android:id="@+id/txtPhoneNo"
android:width="175dp"
android:text="Phone Number: "/>
<TextView android:id="@+id/txtPhoneNoVal"
android:width="175dp"/>
</TableRow>
<TableRow>
<TextView android:id="@+id/txtPhoto"
android:width="175dp"
android:text="Photo: "/>
<ImageView android:id="@+id/imgPhoto"
android:width="175dp"/>
</TableRow>
<TableRow>
<Button android:id="@+id/btnFirst"
android:width="175dp"
android:text="<<"
android:onClick="first"/>
<Button android:id="@+id/btnPrevious"
android:width="175dp"
android:text="<"
android:onClick="previous"/>
</TableRow>
<TableRow>
<Button android:id="@+id/btnNext"
android:width="175dp"
android:text=">"
android:onClick="next"/>
<Button android:id="@+id/btnLast"
android:width="175dp"
android:text=">>"
android:onClick="last"/>
</TableRow>
<TableRow>
<TextView android:id="@+id/txtSearch"
android:width="175dp"
android:text="Search Name: "/>
<AutoCompleteTextView android:id="@+id/txtSearchVal"
android:width="175dp"/>
</TableRow>
<TableRow>
<Button android:id="@+id/btnSearch"
android:width="175dp"
android:text="Search"
android:onClick="search"/>
<Button android:id="@+id/btnClearSearch"
android:width="175dp"
android:text="Clear Search"
android:onClick="clearSearch"/>
</TableRow>
</TableLayout>
检索图像的地址，并使用以下命令访问联系人：
Uri contacts=ContactsContract.Contacts.CONTENT_URI;
接下来，我们创建一个CursorLoader对象按联系人姓名的升序加载所有联系人，如下：
CursorLoader loader=new
CursorLoader(this,contacts,null,null,null,ContactsContract.Contacts.DISPLAY_NAME+" asc");
该CursorLoader构造采用下列参数：
·Context context
·Uri uri
·String projection
·String selection
·String selectionArgs
·String sortOrder
下面的代码将联系人名称填充字符串数组中：
c=loader.loadInBackground();
names=new String<span>[</span>c.getCount()];
int ctr=0;
while(c.moveToNext())
{
names<span>[</span>ctr]=c.getString(c.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
ctr++;
}
在上面的代码中，联系人被加载到Cursor对象，该对象是一个使用loadInBackground（）方法的CursorLoader类。所有联系人姓名存储在一个字符串数组中，并使用Cursor类中的MoveToNext（）方法浏览所有联系人。
此后一个ArrayAdapter被用于将联系人姓名绑定到AutoCompleteTextView如下：
public void showContact(Cursor c)
{
String id=c.getString(c.getColumnIndex(ContactsContract.Contacts._ID));
String displayName=c.getString(c.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
Bitmap photo;
InputStream stream=ContactsContract.Contacts.openContactPhotoInputStream
(getContentResolver(),ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI,Long.parseLong(id)));
if(stream!=null)
{
photo=BitmapFactory.decodeStream(stream);
imgPhoto.setImageBitmap(photo);
}
else
{
imgPhoto.setImageBitmap(null);
}
Cursor phoneCursor=getContentResolver().query
(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,null,ContactsContract.CommonDataKinds.Phone.CONTACT_ID+"="+id,null,null);
String number="";
if(phoneCursor.getCount()>0)
{
phoneCursor.moveToFirst();
number=phoneCursor.getString(phoneCursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
while(phoneCursor.moveToNext())
{
number+=","+phoneCursor.getString(phoneCursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
}
}
phoneCursor.close();
txtIdVal.setText(id);
txtDisplayNameVal.setText(displayName);
txtPhoneNoVal.setText(number);
enableDisableButtons();
}
上面的代码使用cursor参数获取联系人的ID，显示姓名，照片和电话号码。它使用openContactPhotoInputStream（）方法来为照片返回输入流和decodeStream（）方法来读取照片。然后，它使用的setImageBitmap（）方法在ImageView上显示联系人照片。当信息存储在另一个表时，为了显示电话号码我们必须使用另一查询。
以下代码启用和禁用基于所述查询结果的导航按钮：
public void enableDisableButtons()
{
if(c.isFirst()&&c.isLast())
{
btnFirst.setEnabled(false);
btnPrevious.setEnabled(false);
btnNext.setEnabled(false);
btnLast.setEnabled(false);
}
else if(c.isFirst())
{
btnFirst.setEnabled(false);
btnPrevious.setEnabled(false);
btnNext.setEnabled(true);
btnLast.setEnabled(true);
}
else if(c.isLast())
{
btnFirst.setEnabled(true);
btnPrevious.setEnabled(true);
btnNext.setEnabled(false);
btnLast.setEnabled(false);
}
else
{
btnFirst.setEnabled(true);
btnPrevious.setEnabled(true);
btnNext.setEnabled(true);
btnLast.setEnabled(true);
}
}
点击搜索按钮允许你基于名称在搜索文本框中搜索联系方式，如下：
public void search(View v)
{
position=c.getPosition();
if(txtSearchVal.getText().toString().trim().length()>0)
{
Uri contacts=ContactsContract.Contacts.CONTENT_URI;
CursorLoader loader=new CursorLoader
(this,contacts,null,ContactsContract.Contacts.DISPLAY_NAME+"='"+txtSearchVal.getText().toString()+"'",null,
ContactsContract.Contacts.DISPLAY_NAME+" asc");
c=loader.loadInBackground();
if(c.getCount()>0)
{
c.moveToFirst();
}
}
else
{
Uri contacts=ContactsContract.Contacts.CONTENT_URI;
CursorLoader loader=new CursorLoader
(this,contacts,null,null,null,ContactsContract.Contacts.DISPLAY_NAME+" asc");
c=loader.loadInBackground();
c.move(position);
c.moveToNext();
}
if(c.getCount()==0)
{
Toast.makeText(this,"No results found for contact "+txtSearchVal.getText().toString(),Toast.LENGTH_SHORT).show();
showAll();
return;
}
showContact(c);
}
上面的代码实现了通过联系人姓名找到联系方式功能。
点击清除搜索文本框执行下面的代码:
public void clearSearch(View View)
{
showAll();
txtSearchVal.setText("");
}
showAll()方法显示所有联系人，如下:
public void showAll()
{
Uri contacts=ContactsContract.Contacts.CONTENT_URI;
CursorLoader loader=new CursorLoader(this,contacts,null,null,null,ContactsContract.Contacts.DISPLAY_NAME+" asc");
c=loader.loadInBackground();
c.move(position);
c.moveToNext();
showContact(c);
}
下面的代码可以使用导航按钮导航:
public void first(View v)
{
c.moveToFirst();
showContact(c);
}
public void previous(View v)
{
c.moveToPrevious();
showContact(c);
}
public void next(View v)
{
c.moveToNext();
showContact(c);
}
public void last(View v)
{
c.moveToLast();
showContact(c);
}
效果图：
