PhoneGap,API帮助文档翻译整理6-Contacts(通讯录)

Contacts（通讯录）
在交往对象提供对设备的访问联系人数据库。
方法
• • contacts.create contacts.find
参数
• • • • contactFields contactSuccess contactError contactFindOptions
对象
• • • • • • • Contact ContactName ContactField ContactAddress ContactOrganization ContactFindOptions ContactError
contacts.create
返回一个新的联系对象。
var contact = navigator.service.contacts.create(properties);
说明
contacts.create 是一个同步函数，返回一个新的 联系 对象。 这种方法不存在的 联系 对象到设备联系人数据库。要坚持的 联系 对象到设备， 调用 联 系 。保存 方法。
支持的平台 支持的平台
• •
Android BlackBerry WebWorks（操作系统 5.0 和更高版本）

•
iOS
简单的例子
var myContact = navigator.service.contacts.create({"displayName": "Test User"});
完整的例子

Example

Create Contact

contacts.find

查询设备联系人数据库，并返回一个或多个 联系 对象，每个包含字段中指定。
navigator.service.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);
说明
contacts.find 是一个异步函数，查询设备联系人数据库，并返回一个数组的 联系 对 象。 由此产生的对象被传递给 contactSuccess 回调函数指定 contactSuccess 参数。 用户必须指定联系人字段是作为限定在搜索 contactFields 参数。 只有在字段中指 定 contactFields 参数将返回的属性作为 联系的对象传递给 contactSuccess 回调函 数。 一个零长度 contactFields 参数将导致数组 联系 的对象，只有 身份证 填充属性。 该 contactFindOptions 。过滤 字符串可以被用来作为搜索过滤器时，查询联系人数据 库。 如果提供，不区分大小写，部分值匹配应用到指定的每个字段 contactFields 参 数。 如果匹配是一个比较发现 任何 指定的领域，接触被返回。
参数
• • • •
contactFields ：联系人 字段用作搜索预选赛。只有这些领域将有结果值的 联系 对 contactSuccess ： 成功回调函数，从数据库调用的接触与交往返回。 [必需的] contactError ： 错误回调函数。 发生错误时调用。 [可选] contactFindOptions ： 搜索选项来过滤接触。 [可选]
象。 （DOMString []） [必需的]
支持的平台
• • •
Android BlackBerry WebWorks（操作系统 5.0 和更高版本） iOS
简单的例子
function onSuccess(contacts) {
alert('Found ' + contacts.length + ' contacts.'); }; function onError() { alert('onError!'); };

// find all contacts with 'Bob' in any name field var options = new ContactFindOptions(); options.filter="Bob"; var fields = ["displayName", "name"]; navigator.service.contacts.find(fields, onSuccess, onError, options);
完整的例子

闽ICP备16038512号-3 侵权投诉  ©2013-2023 360文档中心,www.360docs.net | 站点地图
本站资源均为网友上传分享，本站仅负责收集和整理，有任何问题请在对应网页下方投诉通道反馈