Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

Addressbook.recordsMatchingSearchElement

Searches matching records.

Component Version macOS Windows Linux Server iOS SDK
Addressbook 5.4 ✅ Yes ❌ No ❌ No ❌ No ❌ No

Deprecated

This function was deprecated. Use Contacts functions instead.

MBS( "Addressbook.recordsMatchingSearchElement"; SearchElement )   More

Parameters

Parameter Description Example
SearchElement The ID for the search element. $SearchElement

Result

Returns list or error.

Description

Searches matching records.
Returns a list of records that match the given search element, or returns an empty array if no records match the search element.

Examples

Find a person with first name being Christian:

Set Variable [$e1; Value:MBS( "Addressbook.searchElementForProperty"; "person"; "FirstNameProperty"; ""; ""; "Christian"; "Equal" )]
Set Variable [$records; Value:MBS( "Addressbook.recordsMatchingSearchElement"; $e1)]
Set Variable [$record; Value:GetValue($records; 1)]
Set Variable [$name; Value:MBS( "Addressbook.record.displayname"; $record )]
Show Custom Dialog [$name]

Search people with related name being John:

Set Variable [$e1; Value:MBS( "Addressbook.searchElementForProperty"; "person"; "RelatedNamesProperty"; ""; ""; "John"; "ContainsSubStringCaseInsensitive" )]
Set Variable [$records; Value:MBS( "Addressbook.recordsMatchingSearchElement"; $e1)]
Set Variable [$record; Value:GetValue($records; 1)]
Set Variable [$name; Value:MBS( "Addressbook.record.displayname"; $record )]
Show Custom Dialog [$name]

See also

Blog Entries

This function is free to use.

Created 26th October 2015, last changed 26th October 2015


Addressbook.record.valueForProperty - Addressbook.removeRecord