Platforms to show: All Mac Windows Linux Cross-Platform
CNContactPickerViewControllerMBS class
Super class: NSViewControllerMBS
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| class | Contacts | MBS Mac64bit Plugin | 22.3 | ❌ No | ❌ No | ❌ No | ✅ Yes | iOS only |
A CNContactPickerViewController allows the user to select one or more contacts (or their properties) from the list of contacts displayed in the contact view controller (CNContactViewController). The picker supports both single selection and multiselection of the contacts. The app using contact picker view does not need access to the user’s contacts and the user will not be prompted for “grant permission” access. The app has access only to the user’s final selection.
There are predefined predicates in this class that let you control the user selection of the contact. Changing the predicates only take effect before the view is presented.
Subclass of the NSViewControllerMBS class.
- 5 events
- event didCancel
- event didSelectContact(contact as CNContactMBS)
- event didSelectContactProperties(contactProperties() as CNContactPropertyMBS)
- event didSelectContactProperty(contactProperty as CNContactPropertyMBS)
- event didSelectContacts(contacts() as CNContactMBS)
- 4 properties
- property isBeingPresented as Boolean
- property predicateForEnablingContact as NSPredicateMBS
- property predicateForSelectionOfContact as NSPredicateMBS
- property predicateForSelectionOfProperty as NSPredicateMBS
- 6 methods
- method Constructor
- method Destructor
- method Dismiss
- method displayedPropertyKeys as String()
- method Present
- method setdisplayedPropertyKeys(displayedPropertyKeys() as String)
- shared method available as Boolean
Super class NSViewControllerMBS
- 7 properties
- property className as string
- property classPath as string
- property Identifier as String
- property representedObject as Variant
- property Title as string
- property view as NSViewMBS
- property viewLoaded as Boolean
- 6 methods
- method Constructor
- method dismissViewController(ViewController as NSViewControllerMBS)
- method loadView
- method presentViewControllerAsModalWindow(ViewController as NSViewControllerMBS)
- method presentViewControllerAsPopover(ViewController as NSViewControllerMBS, RelativeToRect as NSRectMBS, positioningView as NSViewMBS, preferredEdge as Integer, behavior as Integer)
- method presentViewControllerAsSheet(ViewController as NSViewControllerMBS)
- 3 shared methods
- shared method available as boolean
- shared method contentViewController(window as NSWindowMBS) as NSViewControllerMBS
- shared method windowWithContentViewController(ViewController as NSViewControllerMBS) as NSWindowMBS
- 7 constants
Edge Constants
| Constant | Value | Description |
|---|---|---|
| NSMaxXEdge | 2 |
the maximum X edge. Typically right side. |
| NSMaxYEdge | 3 |
The maximum Y edge. Topically the top edge of a window. |
| NSMinXEdge | 0 |
the minimum X edge. Typically left side. |
| NSMinYEdge | 1 |
Minimum Y. As coordinates are upside down in the Cocoa world, this is the bottom edge of a window. |
Behavior modes
| Constant | Value | Description |
|---|---|---|
| PopoverBehaviorApplicationDefined | 0 |
Your application assumes responsibility for closing the popover. AppKit will still close the popover in a limited number of circumstances. For instance, AppKit will attempt to close the popover when the window of its positioningView is closed. The exact interactions in which AppKit will close the popover are not guaranteed. You may consider implementing -cancel: to close the popover when the escape key is pressed. |
| PopoverBehaviorSemitransient | 2 |
AppKit will close the popover when the user interacts with user interface elements in the window containing the popover's positioning view. Semi-transient popovers cannot be shown relative to views in other popovers, nor can they be shown relative to views in child windows. The exact interactions that cause semi-transient popovers to close are not specified. |
| PopoverBehaviorTransient | 1 |
AppKit will close the popover when the user interacts with a user interface element outside the popover. Note that interacting with menus or panels that become key only when needed will not cause a transient popover to close. The exact interactions that will cause transient popovers to close are not specified. |
Super class NSResponderMBS
- 3 properties
- property Handle as Integer
- property menu as NSMenuMBS
- property nextResponder as NSResponderMBS
- 124 methods
- method beginGestureWithEvent(e as NSEventMBS)
- method cancelOperation
- method capitalizeWord
- method centerSelectionInVisibleArea
- method changeCaseOfLetter
- method complete
- method Constructor Private
- method cursorUpdate(e as NSEventMBS)
- method deleteBackward
- method deleteBackwardByDecomposingPreviousCharacter
- method deleteForward
- method deleteToBeginningOfLine
- method deleteToBeginningOfParagraph
- method deleteToEndOfLine
- method deleteToEndOfParagraph
- method deleteToMark
- method deleteWordBackward
- method deleteWordForward
- method endGestureWithEvent(e as NSEventMBS)
- method flagsChanged(e as NSEventMBS)
- method flushBufferedKeyEvents
- method helpRequested(e as NSEventMBS)
- method indent
- method insertBacktab
- method insertContainerBreak
- method insertDoubleQuoteIgnoringSubstitution
- method insertLineBreak
- method insertNewline
- method insertNewlineIgnoringFieldEditor
- method insertParagraphSeparator
- method insertSingleQuoteIgnoringSubstitution
- method insertTab
- method insertTabIgnoringFieldEditor
- method keyDown(e as NSEventMBS)
- method keyUp(e as NSEventMBS)
- method lowercaseWord
- method magnifyWithEvent(e as NSEventMBS)
- method makeBaseWritingDirectionLeftToRight
- method makeBaseWritingDirectionNatural
- method makeBaseWritingDirectionRightToLeft
- method makeTextWritingDirectionLeftToRight
- method makeTextWritingDirectionNatural
- method makeTextWritingDirectionRightToLeft
- method mouseDown(e as NSEventMBS)
- method mouseDragged(e as NSEventMBS)
- method mouseEntered(e as NSEventMBS)
- method mouseExited(e as NSEventMBS)
- method mouseMoved(e as NSEventMBS)
- method mouseUp(e as NSEventMBS)
- method moveBackward
- method moveBackwardAndModifySelection
- method moveDown
- method moveDownAndModifySelection
- method moveForward
- method moveForwardAndModifySelection
- method moveLeft
- method moveLeftAndModifySelection
- method moveParagraphBackwardAndModifySelection
- method moveParagraphForwardAndModifySelection
- method moveRight
- method moveRightAndModifySelection
- method moveToBeginningOfDocument
- method moveToBeginningOfDocumentAndModifySelection
- method moveToBeginningOfLine
- method moveToBeginningOfLineAndModifySelection
- method moveToBeginningOfParagraph
- method moveToBeginningOfParagraphAndModifySelection
- method moveToEndOfDocument
- method moveToEndOfDocumentAndModifySelection
- method moveToEndOfLine
- method moveToEndOfLineAndModifySelection
- method moveToEndOfParagraph
- method moveToEndOfParagraphAndModifySelection
- method moveToLeftEndOfLine
- method moveToLeftEndOfLineAndModifySelection
- method moveToRightEndOfLine
- method moveToRightEndOfLineAndModifySelection
- method moveUp
- method moveUpAndModifySelection
- method moveWordBackward
- method moveWordBackwardAndModifySelection
- method moveWordForward
- method moveWordForwardAndModifySelection
- method moveWordLeft
- method moveWordLeftAndModifySelection
- method moveWordRight
- method moveWordRightAndModifySelection
- method otherMouseDown(e as NSEventMBS)
- method otherMouseDragged(e as NSEventMBS)
- method otherMouseUp(e as NSEventMBS)
- method pageDown
- method pageDownAndModifySelection
- method pageUp
- method pageUpAndModifySelection
- method performMnemonic(theString as string) as boolean
- method presentError(e as NSErrorMBS) as boolean
- method rightMouseDown(e as NSEventMBS)
- method rightMouseDragged(e as NSEventMBS)
- method rightMouseUp(e as NSEventMBS)
- method rotateWithEvent(e as NSEventMBS)
- method scrollLineDown
- method scrollLineUp
- method scrollPageDown
- method scrollPageUp
- method scrollToBeginningOfDocument
- method scrollToEndOfDocument
- method scrollWheel(e as NSEventMBS)
- method selectAll
- method selectLine
- method selectParagraph
- method selectToMark
- method selectWord
- method setMark
- method showContextHelp
- method showWritingTools New in 24.5
- method swapWithMark
- method swipeWithEvent(e as NSEventMBS)
- method tabletPoint(e as NSEventMBS)
- method tabletProximity(e as NSEventMBS)
- method transpose
- method transposeWords
- method undoManager as NSUndoManagerMBS
- method uppercaseWord
- method yank
This class has no sub classes.
Some examples using this class:
Blog Entries
- News from the MBS Xojo Plugins Version 22.3
- MBS Xojo Plugins in version 22.3
- CNContactPickerViewController for Xojo
- MBS Xojo Plugins, version 22.3pr2
Release notes
- Version 22.3
- Added CNContactPickerViewControllerMBS class for iOS to pick contact.
The items on this page are in the following plugins: MBS Mac64bit Plugin, MBS MacBase Plugin.
CNContactPickerMBS - CNContactPropertyMBS
