Monkeybread Software - MBS FileMaker Plugin: CNContactPicker.Show

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 12.0 12.1 12.2 12.3 12.4 12.5 13.0 13.1 13.2 13.3 Statistic FMM Blog

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

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")