Platforms to show: All Mac Windows Linux Cross-Platform
Back to CNContactMBS class.
CNContactMBS.birthday as NSDateComponentsMBS
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Birthdays are represented by this property, whose values are the relevant properties of an NSDateComponents object. Day and month components are required for this property, and year is optional. The calendar component can be nil or NSCalendarIdentifierGregorian. All other date components are invalid and including them results in an NSError object that includes the key paths of the invalid components and the error code CNErrorCodeValidationConfigurationError.
(Read only property)
CNContactMBS.contactType as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Can be CNContactMBS.CNContactTypeOrganization or CNContactMBS.CNContactTypePerson.
(Read only property)
CNContactMBS.departmentName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
(Read only property)
CNContactMBS.familyName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
(Read only property)
CNContactMBS.givenName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
The given name is often known as the first name of the contact.
(Read only property)
CNContactMBS.Handle as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Value is a pointer to a CNContact object.
(Read and Write property)
CNContactMBS.identifier as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
It is recommended that you use the identifier when re-fetching the contact. An identifier can be persisted between the app launches. Note that this identifier only uniquely identifies the contact on the current device.
(Read only property)
CNContactMBS.imageData as MemoryBlock
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
It is recommended that you fetch this property only when you need to access its value, such as when you need to display the contact’s profile picture.
(Read only property)
CNContactMBS.imageDataAvailable as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
(Read only property)
CNContactMBS.jobTitle as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
(Read only property)
CNContactMBS.middleName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
(Read only property)
CNContactMBS.namePrefix as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
(Read only property)
CNContactMBS.nameSuffix as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
(Read only property)
CNContactMBS.nickname as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
(Read only property)
CNContactMBS.nonGregorianBirthday as NSDateComponentsMBS
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Non-Gregorian birthdays can be displayed using this property, whose values are the relevant properties of an NSDateComponents object. Day and month components are required; year and leap month are optional. The calendar component is also required and must be an NSCalendar object with an identifier other than NSCalendarIdentifierGregorian. For example, some supported calendars are Chinese, Hebrew, and Islamic. All other date components are invalid and including them results in an NSError object that includes the key paths of the invalid components and the error code CNErrorCodeValidationConfigurationError.
(Read only property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
To fetch the note property in iOS 13 or later or macOS 16 or later, add the com.apple.developer.contacts.notes entitlement to your app. The entitlement requires permission from Apple to use, and you can’t publicly distribute your app until you have permission to use it. For more information about adding the entitlement and getting permission, see com.apple.developer.contacts.notes.
(Read only property)
CNContactMBS.organizationName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
(Read only property)
CNContactMBS.phoneticFamilyName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
This property contains a string that specifies the pronunciation of the contact’s family (or last) name.
(Read only property)
CNContactMBS.phoneticGivenName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
This property contains a string that specifies the pronunciation of the contact’s given (or first) name.
(Read only property)
CNContactMBS.phoneticMiddleName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
This property contains a string that specifies the pronunciation of the contact’s middle name.
(Read only property)
CNContactMBS.phoneticOrganizationName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 20.5 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
This property contains a string that specifies the pronunciation of the contact’s organization name.
Requires macOS 10.12 or newer.
(Read only property)
CNContactMBS.previousFamilyName as String
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
The previous family name is often known as the maiden name of the contact.
(Read only property)
CNContactMBS.thumbnailImageData as MemoryBlock
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
The thumbnailImageData property is derived from the imageData property, including cropping information from vCards or edits from contact viewing. It is recommended that you fetch this property only when you need to access its value, such as when you need to display the contact’s profile thumbnail picture.
(Read only property)
The items on this page are in the following plugins: MBS Mac64bit Plugin.