65.9K
CodeProject 正在变化。 阅读更多。
Home

Android 中可搜索的联系人列表应用

Azim Zahir
starIconstarIconstarIconstarIcon
emptyStarIcon
starIcon

4.65/5 (6投票s)

2016 年 7 月 15 日

CPOL

3分钟阅读

viewsIcon

18431

downloadIcon

541

本文演示了 Android 中一个简单的可搜索联系人列表。

Sample Image - maximum width is 600 pixels Sample Image - maximum width is 600 pixels

引言

通过本文，我希望解释如何创建一个可搜索的“联系人列表”Android 应用程序。使用此应用程序，用户可以使用导航按钮浏览所有存储的联系人，并根据联系人姓名搜索联系人。该应用程序还可以显示联系人照片（如果可用）。

要浏览联系人，用户可以使用 <<、<、> 和 >> 按钮。

要搜索联系人，用户必须在“搜索姓名”文本框中键入联系人姓名，然后单击“搜索”按钮。单击“清除搜索”按钮会清除“搜索姓名”文本框，并显示开始搜索前最后查看的联系人。

背景

Android 中的联系人使用内容提供程序进行管理。 内容提供程序是一种数据存储，可以像数据库一样进行查询和编辑。它存储数据的方式与使用它的应用程序无关。但是，重要的是要知道如何访问数据才能使用它。

可以通过以下 URI 从联系人表中查询联系人

ContactsContract.Contacts.CONTENT_URI

使用代码

由于此应用程序从设备读取联系人，因此需要在 AndroidManifest.xml 文件中添加以下条目，以允许该应用程序读取联系人：

<uses-permission android:name="android.permission.READ_CONTACTS"/>

以下代码创建一个表格布局以显示联系人

<TableLayout
	xmlns:android="http://schemas.android.com/apk/res/android"
	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

Uri contacts=ContactsContract.Contacts.CONTENT_URI;

接下来，我们创建一个 CursorLoader 对象，以按联系人姓名升序加载所有联系人，如下所示

CursorLoader loader=new CursorLoader(this,contacts,null,null,null,ContactsContract.Contacts.DISPLAY_NAME+" asc");

CursorLoader 构造函数采用以下参数

  • Context 上下文
  • Uri uri
  • String[] projection
  • String selection
  • String[] selectionArgs
  • String sortOrder

以下代码使用联系人姓名填充字符串数组

c=loader.loadInBackground();
names=new String[c.getCount()];
int ctr=0;
while(c.moveToNext())
{
	names[ctr]=c.getString(c.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
	ctr++;
}

在上面的代码中，使用 CursorLoader 类的 loadInBackground() 方法将联系人加载到 Cursor 对象中。 通过使用 Cursor 类的 moveToNext() 方法浏览所有联系人，所有联系人姓名都存储在一个字符串数组中。

此后，使用 ArrayAdapter 将联系人姓名绑定到 AutoCompleteTextView，如下所示

ArrayAdapter adapter=new ArrayAdapter(this,android.R.layout.simple_dropdown_item_1line,names);
txtSearchVal.setThreshold(1);
txtSearchVal.setAdapter(adapter);
c.moveToFirst();
showContact(c);

在上面的代码中，一个名为 txtSearchVal 的 AutoCompleteTextView 用于在用户键入联系人姓名时显示建议的联系人姓名列表。 AutoCompleteTextView 类的 setThreshold() 方法用于指定显示建议列表之前必须键入的最少字符数，而 setAdapter() 方法用于将 ArrayAdapter 绑定到 AutoCompleteTextView。然后，它使用 Cursor 类的 moveToFirst() 方法导航到第一条记录，并使用用户定义的 showContact() 方法显示第一个联系人的详细信息。

编写 showContact() 方法以显示联系人，如下所示

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();
}

上面的代码使用游标参数检索联系人的 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);
}

关注点

在本文中，我试图以一种简单的方式演示如何使用联系人内容提供程序。我希望读者会发现它很有用。

 

© . All rights reserved.