Skip to content

D
Docs

OpenHarmony / Docs
大约 2 年 前同步成功

通知 161
Star 293
Fork 28
D
Docs
提交 0aecbb89 编写于 作者: Z zhouhongli2023
浏览文件
操作

update 

Signed-off-by: Nzhouhongli2023 <zhouhongli5@huawei.com>
上级 548fa99e
隐藏空白更改
内联 并排
Showing with 317 addition and 86 deletion
zh-cn/application-dev/reference/apis/js-apis-contact.md
浏览文件 @ 0aecbb89
...@@ -13,7 +13,7 @@ ...@@ -13,7 +13,7 @@
import contact from '@ohos.contact'; import contact from '@ohos.contact';
``` ```
## contact.addContact<sup>10+<sup> ## contact.addContact<sup>10+</sup>
addContact(context: Context, contact: Contact, callback: AsyncCallback<number>): void addContact(context: Context, contact: Contact, callback: AsyncCallback<number>): void
...@@ -61,12 +61,15 @@ addContact(context: Context, contact: Contact, callback: AsyncCallback<number>): ...@@ -61,12 +61,15 @@ addContact(context: Context, contact: Contact, callback: AsyncCallback<number>):
}); });
``` ```
## contact.addContact(deprecated)<sup>7+<sup> ## contact.addContact(deprecated)<sup>7+</sup>
addContact(contact:Contact, callback:AsyncCallback&lt;number&gt;): void addContact(contact:Contact, callback:AsyncCallback&lt;number&gt;): void
添加联系人，使用callback方式作为异步方法。 添加联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10)
**需要权限**：ohos.permission.WRITE_CONTACTS **需要权限**：ohos.permission.WRITE_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -93,7 +96,7 @@ addContact(contact:Contact, callback:AsyncCallback&lt;number&gt;): void ...@@ -93,7 +96,7 @@ addContact(contact:Contact, callback:AsyncCallback&lt;number&gt;): void
}); });
``` ```
## contact.addContact<sup>10+<sup> ## contact.addContact<sup>10+</sup>
addContact(context: Context, contact: Contact): Promise<number&gt; addContact(context: Context, contact: Contact): Promise<number&gt;
...@@ -145,12 +148,15 @@ addContact(context: Context, contact: Contact): Promise<number&gt; ...@@ -145,12 +148,15 @@ addContact(context: Context, contact: Contact): Promise<number&gt;
}); });
``` ```
## contact.addContact(deprecated)<sup>7+<sup> ## contact.addContact(deprecated)<sup>7+</sup>
addContact(contact: Contact): Promise&lt;number&gt; addContact(contact: Contact): Promise&lt;number&gt;
添加联系人，使用Promise方式作为异步方法。 添加联系人，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[addContact](#addcontact10)
**需要权限**：ohos.permission.WRITE_CONTACTS **需要权限**：ohos.permission.WRITE_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -181,7 +187,7 @@ addContact(contact: Contact): Promise&lt;number&gt; ...@@ -181,7 +187,7 @@ addContact(contact: Contact): Promise&lt;number&gt;
}); });
``` ```
## contact.deleteContact<sup>10+<sup> ## contact.deleteContact<sup>10+</sup>
deleteContact(context: Context, key: string, callback: AsyncCallback&lt;void&gt;): void deleteContact(context: Context, key: string, callback: AsyncCallback&lt;void&gt;): void
...@@ -225,12 +231,15 @@ deleteContact(context: Context, key: string, callback: AsyncCallback&lt;void&gt; ...@@ -225,12 +231,15 @@ deleteContact(context: Context, key: string, callback: AsyncCallback&lt;void&gt;
}); });
``` ```
## contact.deleteContact(deprecated)<sup>7+<sup> ## contact.deleteContact(deprecated)<sup>7+</sup>
deleteContact(key: string, callback: AsyncCallback&lt;void&gt;): void deleteContact(key: string, callback: AsyncCallback&lt;void&gt;): void
删除联系人，使用callback方式作为异步方法。 删除联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[deleteContact](#deletecontact10)
**需要权限**：ohos.permission.WRITE_CONTACTS **需要权限**：ohos.permission.WRITE_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -255,7 +264,7 @@ deleteContact(key: string, callback: AsyncCallback&lt;void&gt;): void ...@@ -255,7 +264,7 @@ deleteContact(key: string, callback: AsyncCallback&lt;void&gt;): void
``` ```
## contact.deleteContact<sup>10+<sup> ## contact.deleteContact<sup>10+</sup>
deleteContact(context: Context, key: string): Promise&lt;void&gt; deleteContact(context: Context, key: string): Promise&lt;void&gt;
...@@ -303,12 +312,15 @@ deleteContact(context: Context, key: string): Promise&lt;void&gt; ...@@ -303,12 +312,15 @@ deleteContact(context: Context, key: string): Promise&lt;void&gt;
}); });
``` ```
## contact.deleteContact(deprecated)<sup>7+<sup> ## contact.deleteContact(deprecated)<sup>7+</sup>
deleteContact(key: string): Promise&lt;void&gt; deleteContact(key: string): Promise&lt;void&gt;
删除联系人，使用Promise方式作为异步方法。 删除联系人，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[deleteContact](#deletecontact10)
**需要权限**：ohos.permission.WRITE_CONTACTS **需要权限**：ohos.permission.WRITE_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -337,7 +349,7 @@ deleteContact(key: string): Promise&lt;void&gt; ...@@ -337,7 +349,7 @@ deleteContact(key: string): Promise&lt;void&gt;
``` ```
## contact.updateContact<sup>10+<sup> ## contact.updateContact<sup>10+</sup>
updateContact(context: Context, contact: Contact, callback: AsyncCallback&lt;void&gt;): void updateContact(context: Context, contact: Contact, callback: AsyncCallback&lt;void&gt;): void
...@@ -385,12 +397,15 @@ updateContact(context: Context, contact: Contact, callback: AsyncCallback&lt;voi ...@@ -385,12 +397,15 @@ updateContact(context: Context, contact: Contact, callback: AsyncCallback&lt;voi
}); });
``` ```
## contact.updateContact(deprecated)<sup>7+<sup> ## contact.updateContact(deprecated)<sup>7+</sup>
updateContact(contact: Contact, callback: AsyncCallback&lt;void&gt;): void updateContact(contact: Contact, callback: AsyncCallback&lt;void&gt;): void
更新联系人，使用callback方式作为异步方法。 更新联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[updateContact](#updatecontact10)
**需要权限**：ohos.permission.WRITE_CONTACTS **需要权限**：ohos.permission.WRITE_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -419,7 +434,7 @@ updateContact(contact: Contact, callback: AsyncCallback&lt;void&gt;): void ...@@ -419,7 +434,7 @@ updateContact(contact: Contact, callback: AsyncCallback&lt;void&gt;): void
``` ```
## contact.updateContact<sup>10+<sup> ## contact.updateContact<sup>10+</sup>
updateContact(context: Context, contact: Contact, attrs: ContactAttributes, callback: AsyncCallback&lt;void&gt;): void updateContact(context: Context, contact: Contact, attrs: ContactAttributes, callback: AsyncCallback&lt;void&gt;): void
...@@ -470,12 +485,15 @@ updateContact(context: Context, contact: Contact, attrs: ContactAttributes, cal ...@@ -470,12 +485,15 @@ updateContact(context: Context, contact: Contact, attrs: ContactAttributes, cal
}); });
``` ```
## contact.updateContact(deprecated)<sup>7+<sup> ## contact.updateContact(deprecated)<sup>7+</sup>
updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallback&lt;void&gt;): void updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallback&lt;void&gt;): void
更新联系人，使用callback方式作为异步方法。 更新联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[updateContact](#updatecontact10)
**需要权限**：ohos.permission.WRITE_CONTACTS **需要权限**：ohos.permission.WRITE_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -507,7 +525,7 @@ updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallbac ...@@ -507,7 +525,7 @@ updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallbac
``` ```
## contact.updateContact<sup>10+<sup> ## contact.updateContact<sup>10+</sup>
updateContact(context: Context, contact: Contact, attrs?: ContactAttributes): Promise&lt;void&gt; updateContact(context: Context, contact: Contact, attrs?: ContactAttributes): Promise&lt;void&gt;
...@@ -562,12 +580,15 @@ updateContact(context: Context, contact: Contact, attrs?: ContactAttributes): P ...@@ -562,12 +580,15 @@ updateContact(context: Context, contact: Contact, attrs?: ContactAttributes): P
}); });
``` ```
## contact.updateContact(deprecated)<sup>7+<sup> ## contact.updateContact(deprecated)<sup>7+</sup>
updateContact(contact: Contact, attrs?: ContactAttributes): Promise&lt;void&gt; updateContact(contact: Contact, attrs?: ContactAttributes): Promise&lt;void&gt;
更新联系人，使用Promise方式作为异步方法。 更新联系人，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[updateContact](#updatecontact10)
**需要权限**：ohos.permission.WRITE_CONTACTS **需要权限**：ohos.permission.WRITE_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -602,7 +623,7 @@ updateContact(contact: Contact, attrs?: ContactAttributes): Promise&lt;void&gt; ...@@ -602,7 +623,7 @@ updateContact(contact: Contact, attrs?: ContactAttributes): Promise&lt;void&gt;
``` ```
## contact.isLocalContact<sup>10+<sup> ## contact.isLocalContact<sup>10+</sup>
isLocalContact(context: Context, id: number, callback: AsyncCallback&lt;boolean&gt;): void isLocalContact(context: Context, id: number, callback: AsyncCallback&lt;boolean&gt;): void
...@@ -646,12 +667,15 @@ isLocalContact(context: Context, id: number, callback: AsyncCallback&lt;boolean ...@@ -646,12 +667,15 @@ isLocalContact(context: Context, id: number, callback: AsyncCallback&lt;boolean
}); });
``` ```
## contact.isLocalContact(deprecated)<sup>7+<sup> ## contact.isLocalContact(deprecated)<sup>7+</sup>
isLocalContact(id: number, callback: AsyncCallback&lt;boolean&gt;): void isLocalContact(id: number, callback: AsyncCallback&lt;boolean&gt;): void
判断当前联系人id是否在电话簿中，使用callback方式作为异步方法。 判断当前联系人id是否在电话簿中，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[isLocalContact](#islocalcontact10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -675,7 +699,7 @@ isLocalContact(id: number, callback: AsyncCallback&lt;boolean&gt;): void ...@@ -675,7 +699,7 @@ isLocalContact(id: number, callback: AsyncCallback&lt;boolean&gt;): void
}); });
``` ```
## contact.isLocalContact<sup>10+<sup> ## contact.isLocalContact<sup>10+</sup>
isLocalContact(context: Context, id: number): Promise&lt;boolean&gt; isLocalContact(context: Context, id: number): Promise&lt;boolean&gt;
...@@ -723,12 +747,15 @@ isLocalContact(context: Context, id: number): Promise&lt;boolean&gt; ...@@ -723,12 +747,15 @@ isLocalContact(context: Context, id: number): Promise&lt;boolean&gt;
}); });
``` ```
## contact.isLocalContact(deprecated)<sup>7+<sup> ## contact.isLocalContact(deprecated)<sup>7+</sup>
isLocalContact(id: number): Promise&lt;boolean&gt; isLocalContact(id: number): Promise&lt;boolean&gt;
判断当前联系人id是否在电话簿中，使用Promise方式作为异步方法。 判断当前联系人id是否在电话簿中，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[isLocalContact](#islocalcontact10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -756,7 +783,7 @@ isLocalContact(id: number): Promise&lt;boolean&gt; ...@@ -756,7 +783,7 @@ isLocalContact(id: number): Promise&lt;boolean&gt;
}); });
``` ```
## contact.isMyCard<sup>10+<sup> ## contact.isMyCard<sup>10+</sup>
isMyCard(context: Context, id: number, callback: AsyncCallback&lt;boolean&gt;): void isMyCard(context: Context, id: number, callback: AsyncCallback&lt;boolean&gt;): void
...@@ -800,12 +827,15 @@ isMyCard(context: Context, id: number, callback: AsyncCallback&lt;boolean&gt;): ...@@ -800,12 +827,15 @@ isMyCard(context: Context, id: number, callback: AsyncCallback&lt;boolean&gt;):
}); });
``` ```
## contact.isMyCard(deprecated)<sup>7+<sup> ## contact.isMyCard(deprecated)<sup>7+</sup>
isMyCard(id: number, callback: AsyncCallback&lt;boolean&gt;): void isMyCard(id: number, callback: AsyncCallback&lt;boolean&gt;): void
判断是否为“我的名片”，使用callback方式作为异步方法。 判断是否为“我的名片”，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[isMyCard](#ismycard10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -830,7 +860,7 @@ isMyCard(id: number, callback: AsyncCallback&lt;boolean&gt;): void ...@@ -830,7 +860,7 @@ isMyCard(id: number, callback: AsyncCallback&lt;boolean&gt;): void
``` ```
## contact.isMyCard<sup>10+<sup> ## contact.isMyCard<sup>10+</sup>
isMyCard(context: Context, id: number): Promise&lt;boolean&gt; isMyCard(context: Context, id: number): Promise&lt;boolean&gt;
...@@ -878,12 +908,15 @@ isMyCard(context: Context, id: number): Promise&lt;boolean&gt; ...@@ -878,12 +908,15 @@ isMyCard(context: Context, id: number): Promise&lt;boolean&gt;
}); });
``` ```
## contact.isMyCard(deprecated)<sup>7+<sup> ## contact.isMyCard(deprecated)<sup>7+</sup>
isMyCard(id: number): Promise&lt;boolean&gt; isMyCard(id: number): Promise&lt;boolean&gt;
判断是否为“我的名片”，使用Promise方式作为异步方法。 判断是否为“我的名片”，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[isMyCard](#ismycard10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -911,7 +944,7 @@ isMyCard(id: number): Promise&lt;boolean&gt; ...@@ -911,7 +944,7 @@ isMyCard(id: number): Promise&lt;boolean&gt;
}); });
``` ```
## contact.queryMyCard<sup>10+<sup> ## contact.queryMyCard<sup>10+</sup>
queryMyCard(context: Context, callback: AsyncCallback&lt;Contact&gt;): void queryMyCard(context: Context, callback: AsyncCallback&lt;Contact&gt;): void
...@@ -954,12 +987,15 @@ queryMyCard(context: Context, callback: AsyncCallback&lt;Contact&gt;): void ...@@ -954,12 +987,15 @@ queryMyCard(context: Context, callback: AsyncCallback&lt;Contact&gt;): void
}); });
``` ```
## contact.queryMyCard(deprecated)<sup>7+<sup> ## contact.queryMyCard(deprecated)<sup>7+</sup>
queryMyCard(callback: AsyncCallback&lt;Contact&gt;): void queryMyCard(callback: AsyncCallback&lt;Contact&gt;): void
查询“我的名片”，使用callback方式作为异步方法。 查询“我的名片”，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryMyCard](#querymycard10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -982,7 +1018,7 @@ queryMyCard(callback: AsyncCallback&lt;Contact&gt;): void ...@@ -982,7 +1018,7 @@ queryMyCard(callback: AsyncCallback&lt;Contact&gt;): void
}); });
``` ```
## contact.queryMyCard<sup>10+<sup> ## contact.queryMyCard<sup>10+</sup>
queryMyCard(context: Context, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void queryMyCard(context: Context, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void
...@@ -1028,12 +1064,15 @@ queryMyCard(context: Context, attrs: ContactAttributes, callback: AsyncCallback ...@@ -1028,12 +1064,15 @@ queryMyCard(context: Context, attrs: ContactAttributes, callback: AsyncCallback
}); });
``` ```
## contact.queryMyCard(deprecated)<sup>7+<sup> ## contact.queryMyCard(deprecated)<sup>7+</sup>
queryMyCard(attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void queryMyCard(attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void
查询“我的名片”，使用callback方式作为异步方法。 查询“我的名片”，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryMyCard](#querymycard10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1059,7 +1098,7 @@ queryMyCard(attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): v ...@@ -1059,7 +1098,7 @@ queryMyCard(attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): v
}); });
``` ```
## contact.queryMyCard<sup>10+<sup> ## contact.queryMyCard<sup>10+</sup>
queryMyCard(context: Context, attrs?: ContactAttributes): Promise&lt;Contact&gt; queryMyCard(context: Context, attrs?: ContactAttributes): Promise&lt;Contact&gt;
...@@ -1109,12 +1148,15 @@ queryMyCard(context: Context, attrs?: ContactAttributes): Promise&lt;Contact&gt ...@@ -1109,12 +1148,15 @@ queryMyCard(context: Context, attrs?: ContactAttributes): Promise&lt;Contact&gt
}); });
``` ```
## contact.queryMyCard(deprecated)<sup>7+<sup> ## contact.queryMyCard(deprecated)<sup>7+</sup>
queryMyCard(attrs?: ContactAttributes): Promise&lt;Contact&gt; queryMyCard(attrs?: ContactAttributes): Promise&lt;Contact&gt;
查询“我的名片”，使用Promise方式作为异步方法。 查询“我的名片”，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryMyCard](#querymycard10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1144,7 +1186,7 @@ queryMyCard(attrs?: ContactAttributes): Promise&lt;Contact&gt; ...@@ -1144,7 +1186,7 @@ queryMyCard(attrs?: ContactAttributes): Promise&lt;Contact&gt;
``` ```
## contact.selectContact<sup>7+<sup> ## contact.selectContact(deprecated)<sup>7+</sup>
selectContact(callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void selectContact(callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -1171,7 +1213,7 @@ selectContact(callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void ...@@ -1171,7 +1213,7 @@ selectContact(callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
``` ```
## contact.selectContact<sup>7+<sup> ## contact.selectContact(deprecated)<sup>7+</sup>
selectContact(): Promise&lt;Array&lt;Contact&gt;&gt; selectContact(): Promise&lt;Array&lt;Contact&gt;&gt;
...@@ -1196,8 +1238,113 @@ selectContact(): Promise&lt;Array&lt;Contact&gt;&gt; ...@@ -1196,8 +1238,113 @@ selectContact(): Promise&lt;Array&lt;Contact&gt;&gt;
}); });
``` ```
## contact.selectContacts<sup>10+</sup>
selectContacts(callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
选择联系人，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Applications.Contacts
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------ |
| callback | AsyncCallback&lt;Array&lt;[Contact](#contact)&gt;&gt; | 是 | 回调函数，返回选择的联系人对象数组。 |
**示例：**
```js
contact.selectContacts((err, data) => {
if (err) {
console.log(`selectContact callback: err->${JSON.stringify(err)}`);
return;
}
console.log(`selectContact callback: success data->${JSON.stringify(data)}`);
});
```
## contact.selectContacts<sup>10+</sup>
selectContacts(): Promise&lt;Array&lt;Contact&gt;&gt;
选择联系人，使用Promise方式作为异步方法。
**系统能力**：SystemCapability.Applications.Contacts
**返回值：**
| 类型 | 说明 |
| ----------------------------------------------- | ------------------------------------------------- |
| Promise&lt;Array&lt;[Contact](#contact)&gt;&gt; | 以Promise形式返回结果，返回选择的联系人对象数组。 |
**示例：**
```js
let promise = contact.selectContacts();
promise.then((data) => {
console.log(`selectContact success: data->${JSON.stringify(data)}`);
}).catch((err) => {
console.error(`selectContact fail: err->${JSON.stringify(err)}`);
});
```
## contact.selectContacts<sup>10+</sup>
selectContacts(options: ContactSelectionOptions, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
选择联系人，使用callback方式作为异步方法。
**系统能力**：SystemCapability.Applications.Contacts
**参数：**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ----------------------------------------------------- | ---- | ------------------------------------ |
| options | ContactSelectionOptions | 是 | 选择联系人时的筛选条件 |
| callback | AsyncCallback&lt;Array&lt;[Contact](#contact)&gt;&gt; | 是 | 回调函数，返回选择的联系人对象数组。 |
**示例：**
```js
contact.selectContacts({
isMultiSelect:false
}, (err, data) => {
if (err) {
console.log(`selectContact callback: err->${JSON.stringify(err)}`);
return;
}
console.log(`selectContact callback: success data->${JSON.stringify(data)}`);
});
```
## contact.selectContacts<sup>10+</sup>
selectContacts(options: ContactSelectionOptions): Promise&lt;Array&lt;Contact&gt;&gt;
选择联系人，使用Promise方式作为异步方法。
**系统能力**：SystemCapability.Applications.Contacts
**返回值：**
| 类型 | 说明 |
| ----------------------------------------------- | ------------------------------------------------- |
| options | ContactSelectionOptions | 是 | 选择联系人时的筛选条件 |
| Promise&lt;Array&lt;[Contact](#contact)&gt;&gt; | 以Promise形式返回结果，返回选择的联系人对象数组。 |
**示例：**
```js
let promise = contact.selectContacts({isMultiSelect:false});
promise.then((data) => {
console.log(`selectContact success: data->${JSON.stringify(data)}`);
}).catch((err) => {
console.error(`selectContact fail: err->${JSON.stringify(err)}`);
});
```
## contact.queryContact<sup>10+<sup> ## contact.queryContact<sup>10+</sup>
queryContact(context: Context, key: string, callback: AsyncCallback&lt;Contact&gt;): void queryContact(context: Context, key: string, callback: AsyncCallback&lt;Contact&gt;): void
...@@ -1241,12 +1388,15 @@ queryContact(context: Context, key: string, callback: AsyncCallback&lt;Contact ...@@ -1241,12 +1388,15 @@ queryContact(context: Context, key: string, callback: AsyncCallback&lt;Contact
}); });
``` ```
## contact.queryContact(deprecated)<sup>7+<sup> ## contact.queryContact(deprecated)<sup>7+</sup>
queryContact(key: string, callback: AsyncCallback&lt;Contact&gt;): void queryContact(key: string, callback: AsyncCallback&lt;Contact&gt;): void
根据key查询联系人，使用callback方式作为异步方法。 根据key查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1271,7 +1421,7 @@ queryContact(key: string, callback: AsyncCallback&lt;Contact&gt;): void ...@@ -1271,7 +1421,7 @@ queryContact(key: string, callback: AsyncCallback&lt;Contact&gt;): void
``` ```
## contact.queryContact<sup>10+<sup> ## contact.queryContact<sup>10+</sup>
queryContact(context: Context, key: string, holder: Holder, callback: AsyncCallback&lt;Contact&gt;): void queryContact(context: Context, key: string, holder: Holder, callback: AsyncCallback&lt;Contact&gt;): void
...@@ -1320,12 +1470,15 @@ queryContact(context: Context, key: string, holder: Holder, callback: AsyncCall ...@@ -1320,12 +1470,15 @@ queryContact(context: Context, key: string, holder: Holder, callback: AsyncCall
}); });
``` ```
## contact.queryContact(deprecated)<sup>7+<sup> ## contact.queryContact(deprecated)<sup>7+</sup>
queryContact(key: string, holder: Holder, callback: AsyncCallback&lt;Contact&gt;): void queryContact(key: string, holder: Holder, callback: AsyncCallback&lt;Contact&gt;): void
根据key查询联系人，使用callback方式作为异步方法。 根据key查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1354,7 +1507,7 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback&lt;Contact&gt; ...@@ -1354,7 +1507,7 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback&lt;Contact&gt;
}); });
``` ```
## contact.queryContact<sup>10+<sup> ## contact.queryContact<sup>10+</sup>
queryContact(context: Context, key: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void queryContact(context: Context, key: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void
...@@ -1401,12 +1554,15 @@ queryContact(context: Context, key: string, attrs: ContactAttributes, callback ...@@ -1401,12 +1554,15 @@ queryContact(context: Context, key: string, attrs: ContactAttributes, callback
}); });
``` ```
## contact.queryContact(deprecated)<sup>7+<sup> ## contact.queryContact(deprecated)<sup>7+</sup>
queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void
根据key查询联系人，使用callback方式作为异步方法。 根据key查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1433,7 +1589,7 @@ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback&lt; ...@@ -1433,7 +1589,7 @@ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback&lt;
}); });
``` ```
## contact.queryContact<sup>10+<sup> ## contact.queryContact<sup>10+</sup>
queryContact(context: Context, key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void queryContact(context: Context, key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void
...@@ -1485,12 +1641,15 @@ queryContact(context: Context, key: string, holder: Holder, attrs: ContactAttri ...@@ -1485,12 +1641,15 @@ queryContact(context: Context, key: string, holder: Holder, attrs: ContactAttri
}); });
``` ```
## contact.queryContact(deprecated)<sup>7+<sup> ## contact.queryContact(deprecated)<sup>7+</sup>
queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Contact&gt;): void
根据key查询联系人，使用callback方式作为异步方法。 根据key查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1523,7 +1682,7 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As ...@@ -1523,7 +1682,7 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As
``` ```
## contact.queryContact<sup>10+<sup> ## contact.queryContact<sup>10+</sup>
queryContact(context: Context, key: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Contact&gt; queryContact(context: Context, key: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Contact&gt;
...@@ -1578,12 +1737,15 @@ queryContact(context: Context, key: string, holder?: Holder, attrs?: ContactAtt ...@@ -1578,12 +1737,15 @@ queryContact(context: Context, key: string, holder?: Holder, attrs?: ContactAtt
}); });
``` ```
## contact.queryContact(deprecated)<sup>7+<sup> ## contact.queryContact(deprecated)<sup>7+</sup>
queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Contact&gt; queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Contact&gt;
根据key查询联系人，使用Promise方式作为异步方法。 根据key查询联系人，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1618,7 +1780,7 @@ queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise&l ...@@ -1618,7 +1780,7 @@ queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise&l
}); });
``` ```
## contact.queryContacts<sup>10+<sup> ## contact.queryContacts<sup>10+</sup>
queryContacts(context: Context, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContacts(context: Context, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -1661,12 +1823,15 @@ queryContacts(context: Context, callback: AsyncCallback&lt;Array&lt;Contact&gt; ...@@ -1661,12 +1823,15 @@ queryContacts(context: Context, callback: AsyncCallback&lt;Array&lt;Contact&gt;
}); });
``` ```
## contact.queryContacts(deprecated)<sup>7+<sup> ## contact.queryContacts(deprecated)<sup>7+</sup>
queryContacts(callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContacts(callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
查询所有联系人，使用callback方式作为异步方法。 查询所有联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1689,7 +1854,7 @@ queryContacts(callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void ...@@ -1689,7 +1854,7 @@ queryContacts(callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
}); });
``` ```
## contact.queryContacts<sup>10+<sup> ## contact.queryContacts<sup>10+</sup>
queryContacts(context: Context, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContacts(context: Context, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -1737,12 +1902,15 @@ queryContacts(context: Context, holder: Holder, callback: AsyncCallback&lt;Arra ...@@ -1737,12 +1902,15 @@ queryContacts(context: Context, holder: Holder, callback: AsyncCallback&lt;Arra
}); });
``` ```
## contact.queryContacts(deprecated)<sup>7+<sup> ## contact.queryContacts(deprecated)<sup>7+</sup>
queryContacts(holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContacts(holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
查询所有联系人，使用callback方式作为异步方法。 查询所有联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1770,7 +1938,7 @@ queryContacts(holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt ...@@ -1770,7 +1938,7 @@ queryContacts(holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt
}); });
``` ```
## contact.queryContacts<sup>10+<sup> ## contact.queryContacts<sup>10+</sup>
queryContacts(context: Context, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContacts(context: Context, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -1816,12 +1984,15 @@ queryContacts(context: Context, attrs: ContactAttributes, callback: AsyncCallba ...@@ -1816,12 +1984,15 @@ queryContacts(context: Context, attrs: ContactAttributes, callback: AsyncCallba
}); });
``` ```
## contact.queryContacts(deprecated)<sup>7+<sup> ## contact.queryContacts(deprecated)<sup>7+</sup>
queryContacts(attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContacts(attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
查询所有联系人，使用callback方式作为异步方法。 查询所有联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1847,7 +2018,7 @@ queryContacts(attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Cont ...@@ -1847,7 +2018,7 @@ queryContacts(attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Cont
}); });
``` ```
## contact.queryContacts<sup>10+<sup> ## contact.queryContacts<sup>10+</sup>
queryContacts(context: Context, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContacts(context: Context, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -1898,12 +2069,15 @@ queryContacts(context: Context, holder: Holder, attrs: ContactAttributes, callb ...@@ -1898,12 +2069,15 @@ queryContacts(context: Context, holder: Holder, attrs: ContactAttributes, callb
}); });
``` ```
## contact.queryContacts(deprecated)<sup>7+<sup> ## contact.queryContacts(deprecated)<sup>7+</sup>
queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
查询所有联系人，使用callback方式作为异步方法。 查询所有联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -1934,7 +2108,7 @@ queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback& ...@@ -1934,7 +2108,7 @@ queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&
}); });
``` ```
## contact.queryContacts<sup>10+<sup> ## contact.queryContacts<sup>10+</sup>
queryContacts(context: Context, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt; queryContacts(context: Context, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt;
...@@ -1988,12 +2162,15 @@ queryContacts(context: Context, holder?: Holder, attrs?: ContactAttributes): Pr ...@@ -1988,12 +2162,15 @@ queryContacts(context: Context, holder?: Holder, attrs?: ContactAttributes): Pr
}); });
``` ```
## contact.queryContacts(deprecated)<sup>7+<sup> ## contact.queryContacts(deprecated)<sup>7+</sup>
queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt; queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt;
查询所有联系人，使用Promise方式作为异步方法。 查询所有联系人，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2028,7 +2205,7 @@ queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;C ...@@ -2028,7 +2205,7 @@ queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;C
}); });
``` ```
## contact.queryContactsByPhoneNumber<sup>10+<sup> ## contact.queryContactsByPhoneNumber<sup>10+</sup>
queryContactsByPhoneNumber(context: Context, phoneNumber: string, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByPhoneNumber(context: Context, phoneNumber: string, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -2072,12 +2249,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, callback: Asy ...@@ -2072,12 +2249,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, callback: Asy
}); });
``` ```
## contact.queryContactsByPhoneNumber(deprecated)<sup>7+<sup> ## contact.queryContactsByPhoneNumber(deprecated)<sup>7+</sup>
queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
根据电话号码查询联系人，使用callback方式作为异步方法。 根据电话号码查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2102,7 +2282,7 @@ queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback&lt;Array ...@@ -2102,7 +2282,7 @@ queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback&lt;Array
``` ```
## contact.queryContactsByPhoneNumber<sup>10+<sup> ## contact.queryContactsByPhoneNumber<sup>10+</sup>
queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -2151,12 +2331,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holde ...@@ -2151,12 +2331,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holde
}); });
``` ```
## contact.queryContactsByPhoneNumber(deprecated)<sup>7+<sup> ## contact.queryContactsByPhoneNumber(deprecated)<sup>7+</sup>
queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
根据电话号码查询联系人，使用callback方式作为异步方法。 根据电话号码查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2185,7 +2368,7 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncC ...@@ -2185,7 +2368,7 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncC
}); });
``` ```
## contact.queryContactsByPhoneNumber<sup>10+<sup> ## contact.queryContactsByPhoneNumber<sup>10+</sup>
queryContactsByPhoneNumber(context: Context, phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByPhoneNumber(context: Context, phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -2232,12 +2415,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, attrs: Contac ...@@ -2232,12 +2415,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, attrs: Contac
}); });
``` ```
## contact.queryContactsByPhoneNumber(deprecated)<sup>7+<sup> ## contact.queryContactsByPhoneNumber(deprecated)<sup>7+</sup>
queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
根据电话号码查询联系人，使用callback方式作为异步方法。 根据电话号码查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2264,7 +2450,7 @@ queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callba ...@@ -2264,7 +2450,7 @@ queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callba
}); });
``` ```
## contact.queryContactsByPhoneNumber<sup>10+<sup> ## contact.queryContactsByPhoneNumber<sup>10+</sup>
queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -2316,12 +2502,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holde ...@@ -2316,12 +2502,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holde
}); });
``` ```
## contact.queryContactsByPhoneNumber(deprecated)<sup>7+<sup> ## contact.queryContactsByPhoneNumber(deprecated)<sup>7+</sup>
queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
根据电话号码查询联系人，使用callback方式作为异步方法。 根据电话号码查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2353,7 +2542,7 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAt ...@@ -2353,7 +2542,7 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAt
}); });
``` ```
## contact.queryContactsByPhoneNumber<sup>10+<sup> ## contact.queryContactsByPhoneNumber<sup>10+</sup>
queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt; queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt;
...@@ -2409,12 +2598,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder?: Hold ...@@ -2409,12 +2598,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder?: Hold
}); });
``` ```
## contact.queryContactsByPhoneNumber(deprecated)<sup>7+<sup> ## contact.queryContactsByPhoneNumber(deprecated)<sup>7+</sup>
queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt; queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt;
根据电话号码查询联系人，使用Promise方式作为异步方法。 根据电话号码查询联系人，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2450,7 +2642,7 @@ queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: Contact ...@@ -2450,7 +2642,7 @@ queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: Contact
}); });
``` ```
## contact.queryContactsByEmail<sup>10+<sup> ## contact.queryContactsByEmail<sup>10+</sup>
queryContactsByEmail(context: Context, email: string, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByEmail(context: Context, email: string, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -2494,12 +2686,15 @@ queryContactsByEmail(context: Context, email: string, callback: AsyncCallback&l ...@@ -2494,12 +2686,15 @@ queryContactsByEmail(context: Context, email: string, callback: AsyncCallback&l
}); });
``` ```
## contact.queryContactsByEmail(deprecated)<sup>7+<sup> ## contact.queryContactsByEmail(deprecated)<sup>7+</sup>
queryContactsByEmail(email: string, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByEmail(email: string, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
根据email查询联系人，使用callback方式作为异步方法。 根据email查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2523,7 +2718,7 @@ queryContactsByEmail(email: string, callback: AsyncCallback&lt;Array&lt;Contact& ...@@ -2523,7 +2718,7 @@ queryContactsByEmail(email: string, callback: AsyncCallback&lt;Array&lt;Contact&
}); });
``` ```
## contact.queryContactsByEmail<sup>10+<sup> ## contact.queryContactsByEmail<sup>10+</sup>
queryContactsByEmail(context: Context, email: string, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByEmail(context: Context, email: string, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -2572,12 +2767,15 @@ queryContactsByEmail(context: Context, email: string, holder: Holder, callback: ...@@ -2572,12 +2767,15 @@ queryContactsByEmail(context: Context, email: string, holder: Holder, callback:
}); });
``` ```
## contact.queryContactsByEmail(deprecated)<sup>7+<sup> ## contact.queryContactsByEmail(deprecated)<sup>7+</sup>
queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
根据email查询联系人，使用callback方式作为异步方法。 根据email查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2606,7 +2804,7 @@ queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback&lt;A ...@@ -2606,7 +2804,7 @@ queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback&lt;A
}); });
``` ```
## contact.queryContactsByEmail<sup>10+<sup> ## contact.queryContactsByEmail<sup>10+</sup>
queryContactsByEmail(context: Context, email: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByEmail(context: Context, email: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -2653,12 +2851,15 @@ queryContactsByEmail(context: Context, email: string, attrs: ContactAttributes, ...@@ -2653,12 +2851,15 @@ queryContactsByEmail(context: Context, email: string, attrs: ContactAttributes,
}); });
``` ```
## contact.queryContactsByEmail(deprecated)<sup>7+<sup> ## contact.queryContactsByEmail(deprecated)<sup>7+</sup>
queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
根据email查询联系人，使用callback方式作为异步方法。 根据email查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2685,7 +2886,7 @@ queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCal ...@@ -2685,7 +2886,7 @@ queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCal
}); });
``` ```
## contact.queryContactsByEmail<sup>10+<sup> ## contact.queryContactsByEmail<sup>10+</sup>
queryContactsByEmail(context: Context, email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByEmail(context: Context, email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
...@@ -2737,12 +2938,15 @@ queryContactsByEmail(context: Context, email: string, holder: Holder, attrs: Co ...@@ -2737,12 +2938,15 @@ queryContactsByEmail(context: Context, email: string, holder: Holder, attrs: Co
}); });
``` ```
## contact.queryContactsByEmail(deprecated)<sup>7+<sup> ## contact.queryContactsByEmail(deprecated)<sup>7+</sup>
queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback&lt;Array&lt;Contact&gt;&gt;): void
根据email查询联系人，使用callback方式作为异步方法。 根据email查询联系人，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2774,7 +2978,7 @@ queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, ca ...@@ -2774,7 +2978,7 @@ queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, ca
}); });
``` ```
## contact.queryContactsByEmail<sup>10+<sup> ## contact.queryContactsByEmail<sup>10+</sup>
queryContactsByEmail(context: Context, email: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt; queryContactsByEmail(context: Context, email: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt;
...@@ -2830,12 +3034,15 @@ queryContactsByEmail(context: Context, email: string, holder?: Holder, attrs?: ...@@ -2830,12 +3034,15 @@ queryContactsByEmail(context: Context, email: string, holder?: Holder, attrs?:
}); });
``` ```
## contact.queryContactsByEmail(deprecated)<sup>7+<sup> ## contact.queryContactsByEmail(deprecated)<sup>7+</sup>
queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt; queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): Promise&lt;Array&lt;Contact&gt;&gt;
根据email查询联系人，使用Promise方式作为异步方法。 根据email查询联系人，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2871,7 +3078,7 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): ...@@ -2871,7 +3078,7 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes):
}); });
``` ```
## contact.queryGroups<sup>10+<sup> ## contact.queryGroups<sup>10+</sup>
queryGroups(context: Context, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void queryGroups(context: Context, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void
...@@ -2914,12 +3121,15 @@ queryGroups(context: Context, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt; ...@@ -2914,12 +3121,15 @@ queryGroups(context: Context, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;
}); });
``` ```
## contact.queryGroups(deprecated)<sup>7+<sup> ## contact.queryGroups(deprecated)<sup>7+</sup>
queryGroups(callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void queryGroups(callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void
查询联系人的所有群组，使用callback方式作为异步方法。 查询联系人的所有群组，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryGroups](#querygroups10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -2942,7 +3152,7 @@ queryGroups(callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void ...@@ -2942,7 +3152,7 @@ queryGroups(callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void
}); });
``` ```
## contact.queryGroups<sup>10+<sup> ## contact.queryGroups<sup>10+</sup>
queryGroups(context: Context, holder: Holder, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void queryGroups(context: Context, holder: Holder, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void
...@@ -2990,12 +3200,15 @@ queryGroups(context: Context, holder: Holder, callback: AsyncCallback&lt;Array& ...@@ -2990,12 +3200,15 @@ queryGroups(context: Context, holder: Holder, callback: AsyncCallback&lt;Array&
}); });
``` ```
## contact.queryGroups(deprecated)<sup>7+<sup> ## contact.queryGroups(deprecated)<sup>7+</sup>
queryGroups(holder: Holder, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void queryGroups(holder: Holder, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): void
查询联系人的所有群组，使用callback方式作为异步方法。 查询联系人的所有群组，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryGroups](#querygroups10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -3023,7 +3236,7 @@ queryGroups(holder: Holder, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;): ...@@ -3023,7 +3236,7 @@ queryGroups(holder: Holder, callback: AsyncCallback&lt;Array&lt;Group&gt;&gt;):
}); });
``` ```
## contact.queryGroups<sup>10+<sup> ## contact.queryGroups<sup>10+</sup>
queryGroups(context: Context, holder?: Holder): Promise&lt;Array&lt;Group&gt;&gt; queryGroups(context: Context, holder?: Holder): Promise&lt;Array&lt;Group&gt;&gt;
...@@ -3075,12 +3288,15 @@ queryGroups(context: Context, holder?: Holder): Promise&lt;Array&lt;Group&gt;&g ...@@ -3075,12 +3288,15 @@ queryGroups(context: Context, holder?: Holder): Promise&lt;Array&lt;Group&gt;&g
}); });
``` ```
## contact.queryGroups(deprecated)<sup>7+<sup> ## contact.queryGroups(deprecated)<sup>7+</sup>
queryGroups(holder?: Holder): Promise&lt;Array&lt;Group&gt;&gt; queryGroups(holder?: Holder): Promise&lt;Array&lt;Group&gt;&gt;
查询联系人的所有群组，使用Promise方式作为异步方法。 查询联系人的所有群组，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryGroups](#querygroups10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -3112,7 +3328,7 @@ queryGroups(holder?: Holder): Promise&lt;Array&lt;Group&gt;&gt; ...@@ -3112,7 +3328,7 @@ queryGroups(holder?: Holder): Promise&lt;Array&lt;Group&gt;&gt;
}); });
``` ```
## contact.queryHolders<sup>10+<sup> ## contact.queryHolders<sup>10+</sup>
queryHolders(context: Context, callback: AsyncCallback&lt;Array&lt;Holder&gt;&gt;): void queryHolders(context: Context, callback: AsyncCallback&lt;Array&lt;Holder&gt;&gt;): void
...@@ -3155,12 +3371,15 @@ queryHolders(context: Context, callback: AsyncCallback&lt;Array&lt;Holder&gt;&g ...@@ -3155,12 +3371,15 @@ queryHolders(context: Context, callback: AsyncCallback&lt;Array&lt;Holder&gt;&g
}); });
``` ```
## contact.queryHolders(deprecated)<sup>7+<sup> ## contact.queryHolders(deprecated)<sup>7+</sup>
queryHolders(callback: AsyncCallback&lt;Array&lt;Holder&gt;&gt;): void queryHolders(callback: AsyncCallback&lt;Array&lt;Holder&gt;&gt;): void
查询所有创建联系人的应用信息，使用callback方式作为异步方法。 查询所有创建联系人的应用信息，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryHolders](#queryholders10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -3183,7 +3402,7 @@ queryHolders(callback: AsyncCallback&lt;Array&lt;Holder&gt;&gt;): void ...@@ -3183,7 +3402,7 @@ queryHolders(callback: AsyncCallback&lt;Array&lt;Holder&gt;&gt;): void
}); });
``` ```
## contact.queryHolders<sup>10+<sup> ## contact.queryHolders<sup>10+</sup>
queryHolders(context: Context ): Promise&lt;Array&lt;Holder&gt;&gt; queryHolders(context: Context ): Promise&lt;Array&lt;Holder&gt;&gt;
...@@ -3230,12 +3449,15 @@ queryHolders(context: Context ): Promise&lt;Array&lt;Holder&gt;&gt; ...@@ -3230,12 +3449,15 @@ queryHolders(context: Context ): Promise&lt;Array&lt;Holder&gt;&gt;
}); });
``` ```
## contact.queryHolders(deprecated)<sup>7+<sup> ## contact.queryHolders(deprecated)<sup>7+</sup>
queryHolders(): Promise&lt;Array&lt;Holder&gt;&gt; queryHolders(): Promise&lt;Array&lt;Holder&gt;&gt;
查询所有创建联系人的应用信息，使用Promise方式作为异步方法。 查询所有创建联系人的应用信息，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryHolders](#queryholders10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -3257,7 +3479,7 @@ queryHolders(): Promise&lt;Array&lt;Holder&gt;&gt; ...@@ -3257,7 +3479,7 @@ queryHolders(): Promise&lt;Array&lt;Holder&gt;&gt;
}); });
``` ```
## contact.queryKey<sup>10+<sup> ## contact.queryKey<sup>10+</sup>
queryKey(context: Context, id: number, callback: AsyncCallback&lt;string&gt;): void queryKey(context: Context, id: number, callback: AsyncCallback&lt;string&gt;): void
...@@ -3301,12 +3523,15 @@ queryKey(context: Context, id: number, callback: AsyncCallback&lt;string&gt;): ...@@ -3301,12 +3523,15 @@ queryKey(context: Context, id: number, callback: AsyncCallback&lt;string&gt;):
}); });
``` ```
## contact.queryKey(deprecated)<sup>7+<sup> ## contact.queryKey(deprecated)<sup>7+</sup>
queryKey(id: number, callback: AsyncCallback&lt;string&gt;): void queryKey(id: number, callback: AsyncCallback&lt;string&gt;): void
根据联系人的id查询联系人的key，使用callback方式作为异步方法。 根据联系人的id查询联系人的key，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryKey](#querykey10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -3330,7 +3555,7 @@ queryKey(id: number, callback: AsyncCallback&lt;string&gt;): void ...@@ -3330,7 +3555,7 @@ queryKey(id: number, callback: AsyncCallback&lt;string&gt;): void
}); });
``` ```
## contact.queryKey<sup>10+<sup> ## contact.queryKey<sup>10+</sup>
queryKey(context: Context, id: number, holder: Holder, callback: AsyncCallback&lt;string&gt;): void queryKey(context: Context, id: number, holder: Holder, callback: AsyncCallback&lt;string&gt;): void
...@@ -3379,12 +3604,15 @@ queryKey(context: Context, id: number, holder: Holder, callback: AsyncCallback& ...@@ -3379,12 +3604,15 @@ queryKey(context: Context, id: number, holder: Holder, callback: AsyncCallback&
}); });
``` ```
## contact.queryKey(deprecated)<sup>7+<sup> ## contact.queryKey(deprecated)<sup>7+</sup>
queryKey(id: number, holder: Holder, callback: AsyncCallback&lt;string&gt;): void queryKey(id: number, holder: Holder, callback: AsyncCallback&lt;string&gt;): void
根据联系人的id查询联系人的key，使用callback方式作为异步方法。 根据联系人的id查询联系人的key，使用callback方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryKey](#querykey10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
...@@ -3413,7 +3641,7 @@ queryKey(id: number, holder: Holder, callback: AsyncCallback&lt;string&gt;): voi ...@@ -3413,7 +3641,7 @@ queryKey(id: number, holder: Holder, callback: AsyncCallback&lt;string&gt;): voi
}); });
``` ```
## contact.queryKey<sup>10+<sup> ## contact.queryKey<sup>10+</sup>
queryKey(context: Context, id: number, holder?: Holder): Promise&lt;string&gt; queryKey(context: Context, id: number, holder?: Holder): Promise&lt;string&gt;
...@@ -3466,12 +3694,15 @@ queryKey(context: Context, id: number, holder?: Holder): Promise&lt;string&gt; ...@@ -3466,12 +3694,15 @@ queryKey(context: Context, id: number, holder?: Holder): Promise&lt;string&gt;
}); });
``` ```
## contact.queryKey(deprecated)<sup>7+<sup> ## contact.queryKey(deprecated)<sup>7+</sup>
queryKey(id: number, holder?: Holder): Promise&lt;string&gt; queryKey(id: number, holder?: Holder): Promise&lt;string&gt;
根据联系人的id查询联系人的key，使用Promise方式作为异步方法。 根据联系人的id查询联系人的key，使用Promise方式作为异步方法。
**说明**
从API version 7 开始支持，从API 10 开始废弃，建议使用[queryKey](#querykey10)
**需要权限**：ohos.permission.READ_CONTACTS **需要权限**：ohos.permission.READ_CONTACTS
**系统能力**：SystemCapability.Applications.ContactsData **系统能力**：SystemCapability.Applications.ContactsData
......
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或