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

CNContactPicker.Show

Shows the contact picker to select a contact.

Component Version macOS Windows Linux Server iOS SDK
Contacts 10.1 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "CNContactPicker.Show" { ; Multi or Window; Position } )   More

Parameters

Parameter Description Example Flags
Multi or Window For iOS: Whether to allow multiple selection.
Pass 1 for multiple or 0 for single selection.
Default is single selection.

For MacOS: the window reference name/number.
0 Optional
Position Where to position the popover.
Can be "left" for left of the FileMaker window.
Can be "right" for right side.
Can be "mouse" to place where mouse is, e.g. when using with button.
Can be "toolbar" to center on window hanging from toolbar.
"mouse" Optional

Result

Returns OK or error.

Description

Shows the contact picker to select a contact.
Use CNContactPicker.Current later to get the result.

Examples

Show picker:

# use picker sheet/popover to select contact
Set Variable [ $r ; Value: MBS( "CNContactPicker.SetTrigger"; Get(FileName); "Picked") ]
Set Variable [ $r ; Value: MBS( "CNContactPicker.Show") ]
If [ MBS("IsError") ]
    Show Custom Dialog [ "Failed to show picker" ; $r ]
End If

Show at mouse positon in front window:

MBS( "CNContactPicker.Show"; 0; "mouse")

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 31st January 2020, last changed 4th February 2020


CNContactPicker.SetTrigger - CNContactStore.AddContact