diff --git a/zh-cn/application-dev/reference/apis/js-apis-contact.md b/zh-cn/application-dev/reference/apis/js-apis-contact.md index bc56b744153eb4e5925315d901c0ffedc99d1a74..a1f04433aed65ee8f8526e47bfb31622e438e9c1 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-contact.md +++ b/zh-cn/application-dev/reference/apis/js-apis-contact.md @@ -13,7 +13,7 @@ import contact from '@ohos.contact'; ``` -## contact.addContact10+ +## contact.addContact10+ addContact(context: Context, contact: Contact, callback: AsyncCallback): void @@ -61,12 +61,15 @@ addContact(context: Context, contact: Contact, callback: AsyncCallback): }); ``` -## contact.addContact(deprecated)7+ +## contact.addContact(deprecated)7+ addContact(contact:Contact, callback:AsyncCallback<number>): void 添加联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10) + **需要权限**：ohos.permission.WRITE_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -93,7 +96,7 @@ addContact(contact:Contact, callback:AsyncCallback<number>): void }); ``` -## contact.addContact10+ +## contact.addContact10+ addContact(context: Context, contact: Contact): Promise7+ +## contact.addContact(deprecated)7+ addContact(contact: Contact): Promise<number> 添加联系人，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[addContact](#addcontact10) + **需要权限**：ohos.permission.WRITE_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -181,7 +187,7 @@ addContact(contact: Contact): Promise<number> }); ``` -## contact.deleteContact10+ +## contact.deleteContact10+ deleteContact(context: Context, key: string, callback: AsyncCallback<void>): void @@ -225,12 +231,15 @@ deleteContact(context: Context, key: string, callback: AsyncCallback<void> }); ``` -## contact.deleteContact(deprecated)7+ +## contact.deleteContact(deprecated)7+ deleteContact(key: string, callback: AsyncCallback<void>): void 删除联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[deleteContact](#deletecontact10) + **需要权限**：ohos.permission.WRITE_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -255,7 +264,7 @@ deleteContact(key: string, callback: AsyncCallback<void>): void ``` -## contact.deleteContact10+ +## contact.deleteContact10+ deleteContact(context: Context, key: string): Promise<void> @@ -303,12 +312,15 @@ deleteContact(context: Context, key: string): Promise<void> }); ``` -## contact.deleteContact(deprecated)7+ +## contact.deleteContact(deprecated)7+ deleteContact(key: string): Promise<void> 删除联系人，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[deleteContact](#deletecontact10) + **需要权限**：ohos.permission.WRITE_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -337,7 +349,7 @@ deleteContact(key: string): Promise<void> ``` -## contact.updateContact10+ +## contact.updateContact10+ updateContact(context: Context, contact: Contact, callback: AsyncCallback<void>): void @@ -385,12 +397,15 @@ updateContact(context: Context, contact: Contact, callback: AsyncCallback<voi }); ``` -## contact.updateContact(deprecated)7+ +## contact.updateContact(deprecated)7+ updateContact(contact: Contact, callback: AsyncCallback<void>): void 更新联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[updateContact](#updatecontact10) + **需要权限**：ohos.permission.WRITE_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -419,7 +434,7 @@ updateContact(contact: Contact, callback: AsyncCallback<void>): void ``` -## contact.updateContact10+ +## contact.updateContact10+ updateContact(context: Context, contact: Contact, attrs: ContactAttributes, callback: AsyncCallback<void>): void @@ -470,12 +485,15 @@ updateContact(context: Context, contact: Contact, attrs: ContactAttributes, cal }); ``` -## contact.updateContact(deprecated)7+ +## contact.updateContact(deprecated)7+ updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallback<void>): void 更新联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[updateContact](#updatecontact10) + **需要权限**：ohos.permission.WRITE_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -507,7 +525,7 @@ updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallbac ``` -## contact.updateContact10+ +## contact.updateContact10+ updateContact(context: Context, contact: Contact, attrs?: ContactAttributes): Promise<void> @@ -562,12 +580,15 @@ updateContact(context: Context, contact: Contact, attrs?: ContactAttributes): P }); ``` -## contact.updateContact(deprecated)7+ +## contact.updateContact(deprecated)7+ updateContact(contact: Contact, attrs?: ContactAttributes): Promise<void> 更新联系人，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[updateContact](#updatecontact10) + **需要权限**：ohos.permission.WRITE_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -602,7 +623,7 @@ updateContact(contact: Contact, attrs?: ContactAttributes): Promise<void> ``` -## contact.isLocalContact10+ +## contact.isLocalContact10+ isLocalContact(context: Context, id: number, callback: AsyncCallback<boolean>): void @@ -646,12 +667,15 @@ isLocalContact(context: Context, id: number, callback: AsyncCallback<boolean }); ``` -## contact.isLocalContact(deprecated)7+ +## contact.isLocalContact(deprecated)7+ isLocalContact(id: number, callback: AsyncCallback<boolean>): void 判断当前联系人id是否在电话簿中，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[isLocalContact](#islocalcontact10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -675,7 +699,7 @@ isLocalContact(id: number, callback: AsyncCallback<boolean>): void }); ``` -## contact.isLocalContact10+ +## contact.isLocalContact10+ isLocalContact(context: Context, id: number): Promise<boolean> @@ -723,12 +747,15 @@ isLocalContact(context: Context, id: number): Promise<boolean> }); ``` -## contact.isLocalContact(deprecated)7+ +## contact.isLocalContact(deprecated)7+ isLocalContact(id: number): Promise<boolean> 判断当前联系人id是否在电话簿中，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[isLocalContact](#islocalcontact10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -756,7 +783,7 @@ isLocalContact(id: number): Promise<boolean> }); ``` -## contact.isMyCard10+ +## contact.isMyCard10+ isMyCard(context: Context, id: number, callback: AsyncCallback<boolean>): void @@ -800,12 +827,15 @@ isMyCard(context: Context, id: number, callback: AsyncCallback<boolean>): }); ``` -## contact.isMyCard(deprecated)7+ +## contact.isMyCard(deprecated)7+ isMyCard(id: number, callback: AsyncCallback<boolean>): void 判断是否为“我的名片”，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[isMyCard](#ismycard10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -830,7 +860,7 @@ isMyCard(id: number, callback: AsyncCallback<boolean>): void ``` -## contact.isMyCard10+ +## contact.isMyCard10+ isMyCard(context: Context, id: number): Promise<boolean> @@ -878,12 +908,15 @@ isMyCard(context: Context, id: number): Promise<boolean> }); ``` -## contact.isMyCard(deprecated)7+ +## contact.isMyCard(deprecated)7+ isMyCard(id: number): Promise<boolean> 判断是否为“我的名片”，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[isMyCard](#ismycard10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -911,7 +944,7 @@ isMyCard(id: number): Promise<boolean> }); ``` -## contact.queryMyCard10+ +## contact.queryMyCard10+ queryMyCard(context: Context, callback: AsyncCallback<Contact>): void @@ -954,12 +987,15 @@ queryMyCard(context: Context, callback: AsyncCallback<Contact>): void }); ``` -## contact.queryMyCard(deprecated)7+ +## contact.queryMyCard(deprecated)7+ queryMyCard(callback: AsyncCallback<Contact>): void 查询“我的名片”，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryMyCard](#querymycard10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -982,7 +1018,7 @@ queryMyCard(callback: AsyncCallback<Contact>): void }); ``` -## contact.queryMyCard10+ +## contact.queryMyCard10+ queryMyCard(context: Context, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void @@ -1028,12 +1064,15 @@ queryMyCard(context: Context, attrs: ContactAttributes, callback: AsyncCallback }); ``` -## contact.queryMyCard(deprecated)7+ +## contact.queryMyCard(deprecated)7+ queryMyCard(attrs: ContactAttributes, callback: AsyncCallback<Contact>): void 查询“我的名片”，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryMyCard](#querymycard10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1059,7 +1098,7 @@ queryMyCard(attrs: ContactAttributes, callback: AsyncCallback<Contact>): v }); ``` -## contact.queryMyCard10+ +## contact.queryMyCard10+ queryMyCard(context: Context, attrs?: ContactAttributes): Promise<Contact> @@ -1109,12 +1148,15 @@ queryMyCard(context: Context, attrs?: ContactAttributes): Promise<Contact> }); ``` -## contact.queryMyCard(deprecated)7+ +## contact.queryMyCard(deprecated)7+ queryMyCard(attrs?: ContactAttributes): Promise<Contact> 查询“我的名片”，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryMyCard](#querymycard10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1144,7 +1186,7 @@ queryMyCard(attrs?: ContactAttributes): Promise<Contact> ``` -## contact.selectContact7+ +## contact.selectContact(deprecated)7+ selectContact(callback: AsyncCallback<Array<Contact>>): void @@ -1171,7 +1213,7 @@ selectContact(callback: AsyncCallback<Array<Contact>>): void ``` -## contact.selectContact7+ +## contact.selectContact(deprecated)7+ selectContact(): Promise<Array<Contact>> @@ -1196,8 +1238,113 @@ selectContact(): Promise<Array<Contact>> }); ``` +## contact.selectContacts10+ + +selectContacts(callback: AsyncCallback<Array<Contact>>): void + +选择联系人，使用callback方式作为异步方法。 + +**系统能力**：SystemCapability.Applications.Contacts + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ----------------------------------------------------- | ---- | ------------------------------------ | +| callback | AsyncCallback<Array<[Contact](#contact)>> | 是 | 回调函数，返回选择的联系人对象数组。 | + +**示例：** + + ```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.selectContacts10+ + +selectContacts(): Promise<Array<Contact>> + +选择联系人，使用Promise方式作为异步方法。 + +**系统能力**：SystemCapability.Applications.Contacts + +**返回值：** + +| 类型 | 说明 | +| ----------------------------------------------- | ------------------------------------------------- | +| Promise<Array<[Contact](#contact)>> | 以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.selectContacts10+ + +selectContacts(options: ContactSelectionOptions, callback: AsyncCallback<Array<Contact>>): void + +选择联系人，使用callback方式作为异步方法。 + +**系统能力**：SystemCapability.Applications.Contacts + +**参数：** + +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ----------------------------------------------------- | ---- | ------------------------------------ | +| options | ContactSelectionOptions | 是 | 选择联系人时的筛选条件 | +| callback | AsyncCallback<Array<[Contact](#contact)>> | 是 | 回调函数，返回选择的联系人对象数组。 | + +**示例：** + + ```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.selectContacts10+ + +selectContacts(options: ContactSelectionOptions): Promise<Array<Contact>> + +选择联系人，使用Promise方式作为异步方法。 + +**系统能力**：SystemCapability.Applications.Contacts + +**返回值：** + +| 类型 | 说明 | +| ----------------------------------------------- | ------------------------------------------------- | +| options | ContactSelectionOptions | 是 | 选择联系人时的筛选条件 | +| Promise<Array<[Contact](#contact)>> | 以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.queryContact10+ +## contact.queryContact10+ queryContact(context: Context, key: string, callback: AsyncCallback<Contact>): void @@ -1241,12 +1388,15 @@ queryContact(context: Context, key: string, callback: AsyncCallback<Contact }); ``` -## contact.queryContact(deprecated)7+ +## contact.queryContact(deprecated)7+ queryContact(key: string, callback: AsyncCallback<Contact>): void 根据key查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1271,7 +1421,7 @@ queryContact(key: string, callback: AsyncCallback<Contact>): void ``` -## contact.queryContact10+ +## contact.queryContact10+ queryContact(context: Context, key: string, holder: Holder, callback: AsyncCallback<Contact>): void @@ -1320,12 +1470,15 @@ queryContact(context: Context, key: string, holder: Holder, callback: AsyncCall }); ``` -## contact.queryContact(deprecated)7+ +## contact.queryContact(deprecated)7+ queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact>): void 根据key查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1354,7 +1507,7 @@ queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact> }); ``` -## contact.queryContact10+ +## contact.queryContact10+ queryContact(context: Context, key: string, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void @@ -1401,12 +1554,15 @@ queryContact(context: Context, key: string, attrs: ContactAttributes, callback }); ``` -## contact.queryContact(deprecated)7+ +## contact.queryContact(deprecated)7+ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void 根据key查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1433,7 +1589,7 @@ queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback< }); ``` -## contact.queryContact10+ +## contact.queryContact10+ queryContact(context: Context, key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void @@ -1485,12 +1641,15 @@ queryContact(context: Context, key: string, holder: Holder, attrs: ContactAttri }); ``` -## contact.queryContact(deprecated)7+ +## contact.queryContact(deprecated)7+ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void 根据key查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1523,7 +1682,7 @@ queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: As ``` -## contact.queryContact10+ +## contact.queryContact10+ queryContact(context: Context, key: string, holder?: Holder, attrs?: ContactAttributes): Promise<Contact> @@ -1578,12 +1737,15 @@ queryContact(context: Context, key: string, holder?: Holder, attrs?: ContactAtt }); ``` -## contact.queryContact(deprecated)7+ +## contact.queryContact(deprecated)7+ queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise<Contact> 根据key查询联系人，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContact](#querycontact10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1618,7 +1780,7 @@ queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise&l }); ``` -## contact.queryContacts10+ +## contact.queryContacts10+ queryContacts(context: Context, callback: AsyncCallback<Array<Contact>>): void @@ -1661,12 +1823,15 @@ queryContacts(context: Context, callback: AsyncCallback<Array<Contact> }); ``` -## contact.queryContacts(deprecated)7+ +## contact.queryContacts(deprecated)7+ queryContacts(callback: AsyncCallback<Array<Contact>>): void 查询所有联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1689,7 +1854,7 @@ queryContacts(callback: AsyncCallback<Array<Contact>>): void }); ``` -## contact.queryContacts10+ +## contact.queryContacts10+ queryContacts(context: Context, holder: Holder, callback: AsyncCallback<Array<Contact>>): void @@ -1737,12 +1902,15 @@ queryContacts(context: Context, holder: Holder, callback: AsyncCallback<Arra }); ``` -## contact.queryContacts(deprecated)7+ +## contact.queryContacts(deprecated)7+ queryContacts(holder: Holder, callback: AsyncCallback<Array<Contact>>): void 查询所有联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1770,7 +1938,7 @@ queryContacts(holder: Holder, callback: AsyncCallback<Array<Contact>> }); ``` -## contact.queryContacts10+ +## contact.queryContacts10+ queryContacts(context: Context, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void @@ -1816,12 +1984,15 @@ queryContacts(context: Context, attrs: ContactAttributes, callback: AsyncCallba }); ``` -## contact.queryContacts(deprecated)7+ +## contact.queryContacts(deprecated)7+ queryContacts(attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void 查询所有联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1847,7 +2018,7 @@ queryContacts(attrs: ContactAttributes, callback: AsyncCallback<Array<Cont }); ``` -## contact.queryContacts10+ +## contact.queryContacts10+ queryContacts(context: Context, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void @@ -1898,12 +2069,15 @@ queryContacts(context: Context, holder: Holder, attrs: ContactAttributes, callb }); ``` -## contact.queryContacts(deprecated)7+ +## contact.queryContacts(deprecated)7+ queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void 查询所有联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -1934,7 +2108,7 @@ queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback& }); ``` -## contact.queryContacts10+ +## contact.queryContacts10+ queryContacts(context: Context, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>> @@ -1988,12 +2162,15 @@ queryContacts(context: Context, holder?: Holder, attrs?: ContactAttributes): Pr }); ``` -## contact.queryContacts(deprecated)7+ +## contact.queryContacts(deprecated)7+ queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>> 查询所有联系人，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContacts](#querycontacts10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2028,7 +2205,7 @@ queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise<Array<C }); ``` -## contact.queryContactsByPhoneNumber10+ +## contact.queryContactsByPhoneNumber10+ queryContactsByPhoneNumber(context: Context, phoneNumber: string, callback: AsyncCallback<Array<Contact>>): void @@ -2072,12 +2249,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, callback: Asy }); ``` -## contact.queryContactsByPhoneNumber(deprecated)7+ +## contact.queryContactsByPhoneNumber(deprecated)7+ queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback<Array<Contact>>): void 根据电话号码查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2102,7 +2282,7 @@ queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback<Array ``` -## contact.queryContactsByPhoneNumber10+ +## contact.queryContactsByPhoneNumber10+ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, callback: AsyncCallback<Array<Contact>>): void @@ -2151,12 +2331,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holde }); ``` -## contact.queryContactsByPhoneNumber(deprecated)7+ +## contact.queryContactsByPhoneNumber(deprecated)7+ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncCallback<Array<Contact>>): void 根据电话号码查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2185,7 +2368,7 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncC }); ``` -## contact.queryContactsByPhoneNumber10+ +## contact.queryContactsByPhoneNumber10+ queryContactsByPhoneNumber(context: Context, phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void @@ -2232,12 +2415,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, attrs: Contac }); ``` -## contact.queryContactsByPhoneNumber(deprecated)7+ +## contact.queryContactsByPhoneNumber(deprecated)7+ queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void 根据电话号码查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2264,7 +2450,7 @@ queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callba }); ``` -## contact.queryContactsByPhoneNumber10+ +## contact.queryContactsByPhoneNumber10+ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void @@ -2316,12 +2502,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holde }); ``` -## contact.queryContactsByPhoneNumber(deprecated)7+ +## contact.queryContactsByPhoneNumber(deprecated)7+ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void 根据电话号码查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2353,7 +2542,7 @@ queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAt }); ``` -## contact.queryContactsByPhoneNumber10+ +## contact.queryContactsByPhoneNumber10+ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>> @@ -2409,12 +2598,15 @@ queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder?: Hold }); ``` -## contact.queryContactsByPhoneNumber(deprecated)7+ +## contact.queryContactsByPhoneNumber(deprecated)7+ queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>> 根据电话号码查询联系人，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByPhoneNumber](#querycontactsbyphonenumber10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2450,7 +2642,7 @@ queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: Contact }); ``` -## contact.queryContactsByEmail10+ +## contact.queryContactsByEmail10+ queryContactsByEmail(context: Context, email: string, callback: AsyncCallback<Array<Contact>>): void @@ -2494,12 +2686,15 @@ queryContactsByEmail(context: Context, email: string, callback: AsyncCallback&l }); ``` -## contact.queryContactsByEmail(deprecated)7+ +## contact.queryContactsByEmail(deprecated)7+ queryContactsByEmail(email: string, callback: AsyncCallback<Array<Contact>>): void 根据email查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2523,7 +2718,7 @@ queryContactsByEmail(email: string, callback: AsyncCallback<Array<Contact& }); ``` -## contact.queryContactsByEmail10+ +## contact.queryContactsByEmail10+ queryContactsByEmail(context: Context, email: string, holder: Holder, callback: AsyncCallback<Array<Contact>>): void @@ -2572,12 +2767,15 @@ queryContactsByEmail(context: Context, email: string, holder: Holder, callback: }); ``` -## contact.queryContactsByEmail(deprecated)7+ +## contact.queryContactsByEmail(deprecated)7+ queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback<Array<Contact>>): void 根据email查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2606,7 +2804,7 @@ queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback<A }); ``` -## contact.queryContactsByEmail10+ +## contact.queryContactsByEmail10+ queryContactsByEmail(context: Context, email: string, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void @@ -2653,12 +2851,15 @@ queryContactsByEmail(context: Context, email: string, attrs: ContactAttributes, }); ``` -## contact.queryContactsByEmail(deprecated)7+ +## contact.queryContactsByEmail(deprecated)7+ queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void 根据email查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2685,7 +2886,7 @@ queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCal }); ``` -## contact.queryContactsByEmail10+ +## contact.queryContactsByEmail10+ queryContactsByEmail(context: Context, email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void @@ -2737,12 +2938,15 @@ queryContactsByEmail(context: Context, email: string, holder: Holder, attrs: Co }); ``` -## contact.queryContactsByEmail(deprecated)7+ +## contact.queryContactsByEmail(deprecated)7+ queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void 根据email查询联系人，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2774,7 +2978,7 @@ queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, ca }); ``` -## contact.queryContactsByEmail10+ +## contact.queryContactsByEmail10+ queryContactsByEmail(context: Context, email: string, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>> @@ -2830,12 +3034,15 @@ queryContactsByEmail(context: Context, email: string, holder?: Holder, attrs?: }); ``` -## contact.queryContactsByEmail(deprecated)7+ +## contact.queryContactsByEmail(deprecated)7+ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>> 根据email查询联系人，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryContactsByEmail](#querycontactsbyemail10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2871,7 +3078,7 @@ queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): }); ``` -## contact.queryGroups10+ +## contact.queryGroups10+ queryGroups(context: Context, callback: AsyncCallback<Array<Group>>): void @@ -2914,12 +3121,15 @@ queryGroups(context: Context, callback: AsyncCallback<Array<Group>> }); ``` -## contact.queryGroups(deprecated)7+ +## contact.queryGroups(deprecated)7+ queryGroups(callback: AsyncCallback<Array<Group>>): void 查询联系人的所有群组，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryGroups](#querygroups10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -2942,7 +3152,7 @@ queryGroups(callback: AsyncCallback<Array<Group>>): void }); ``` -## contact.queryGroups10+ +## contact.queryGroups10+ queryGroups(context: Context, holder: Holder, callback: AsyncCallback<Array<Group>>): void @@ -2990,12 +3200,15 @@ queryGroups(context: Context, holder: Holder, callback: AsyncCallback<Array& }); ``` -## contact.queryGroups(deprecated)7+ +## contact.queryGroups(deprecated)7+ queryGroups(holder: Holder, callback: AsyncCallback<Array<Group>>): void 查询联系人的所有群组，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryGroups](#querygroups10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -3023,7 +3236,7 @@ queryGroups(holder: Holder, callback: AsyncCallback<Array<Group>>): }); ``` -## contact.queryGroups10+ +## contact.queryGroups10+ queryGroups(context: Context, holder?: Holder): Promise<Array<Group>> @@ -3075,12 +3288,15 @@ queryGroups(context: Context, holder?: Holder): Promise<Array<Group>&g }); ``` -## contact.queryGroups(deprecated)7+ +## contact.queryGroups(deprecated)7+ queryGroups(holder?: Holder): Promise<Array<Group>> 查询联系人的所有群组，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryGroups](#querygroups10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -3112,7 +3328,7 @@ queryGroups(holder?: Holder): Promise<Array<Group>> }); ``` -## contact.queryHolders10+ +## contact.queryHolders10+ queryHolders(context: Context, callback: AsyncCallback<Array<Holder>>): void @@ -3155,12 +3371,15 @@ queryHolders(context: Context, callback: AsyncCallback<Array<Holder>&g }); ``` -## contact.queryHolders(deprecated)7+ +## contact.queryHolders(deprecated)7+ queryHolders(callback: AsyncCallback<Array<Holder>>): void 查询所有创建联系人的应用信息，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryHolders](#queryholders10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -3183,7 +3402,7 @@ queryHolders(callback: AsyncCallback<Array<Holder>>): void }); ``` -## contact.queryHolders10+ +## contact.queryHolders10+ queryHolders(context: Context ): Promise<Array<Holder>> @@ -3230,12 +3449,15 @@ queryHolders(context: Context ): Promise<Array<Holder>> }); ``` -## contact.queryHolders(deprecated)7+ +## contact.queryHolders(deprecated)7+ queryHolders(): Promise<Array<Holder>> 查询所有创建联系人的应用信息，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryHolders](#queryholders10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -3257,7 +3479,7 @@ queryHolders(): Promise<Array<Holder>> }); ``` -## contact.queryKey10+ +## contact.queryKey10+ queryKey(context: Context, id: number, callback: AsyncCallback<string>): void @@ -3301,12 +3523,15 @@ queryKey(context: Context, id: number, callback: AsyncCallback<string>): }); ``` -## contact.queryKey(deprecated)7+ +## contact.queryKey(deprecated)7+ queryKey(id: number, callback: AsyncCallback<string>): void 根据联系人的id查询联系人的key，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryKey](#querykey10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -3330,7 +3555,7 @@ queryKey(id: number, callback: AsyncCallback<string>): void }); ``` -## contact.queryKey10+ +## contact.queryKey10+ queryKey(context: Context, id: number, holder: Holder, callback: AsyncCallback<string>): void @@ -3379,12 +3604,15 @@ queryKey(context: Context, id: number, holder: Holder, callback: AsyncCallback& }); ``` -## contact.queryKey(deprecated)7+ +## contact.queryKey(deprecated)7+ queryKey(id: number, holder: Holder, callback: AsyncCallback<string>): void 根据联系人的id查询联系人的key，使用callback方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryKey](#querykey10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData @@ -3413,7 +3641,7 @@ queryKey(id: number, holder: Holder, callback: AsyncCallback<string>): voi }); ``` -## contact.queryKey10+ +## contact.queryKey10+ queryKey(context: Context, id: number, holder?: Holder): Promise<string> @@ -3466,12 +3694,15 @@ queryKey(context: Context, id: number, holder?: Holder): Promise<string> }); ``` -## contact.queryKey(deprecated)7+ +## contact.queryKey(deprecated)7+ queryKey(id: number, holder?: Holder): Promise<string> 根据联系人的id查询联系人的key，使用Promise方式作为异步方法。 +**说明** +从API version 7 开始支持，从API 10 开始废弃，建议使用[queryKey](#querykey10) + **需要权限**：ohos.permission.READ_CONTACTS **系统能力**：SystemCapability.Applications.ContactsData