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.
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
- Addressbook.record.displayname
- Addressbook.searchElementForConjunction
- Addressbook.searchElementForProperty
Blog Entries
This function is free to use.
Created 26th October 2015, last changed 26th October 2015
Addressbook.record.valueForProperty - Addressbook.removeRecord