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
A date component for the Gregorian birthday of the contact.

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
An enum identifying the contact type.

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
The name of the department associated with the contact.

(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
The family name of the contact.

(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 of the contact.

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
The internal object reference.

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
A value that uniquely identifies a contact on the device.

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
The profile picture of a contact.

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
Indicates whether a contact has a profile picture.

(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
The contact’s job title.

(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
The middle name of the contact.

(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
The name prefix of the contact.

(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
The name suffix of the contact.

(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
The nickname of the contact.

(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
A date component for the non-Gregorian birthday of the contact.

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)

CNContactMBS.note as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
property Contacts MBS Mac64bit Plugin 16.3 ✅ Yes ❌ No ❌ No ✅ Yes Desktop & iOS
A string containing notes for the contact.

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
The name of the organization associated with the contact.

(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
A string for the phonetic family name of the contact.

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
The phonetic given name of the contact.

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
The phonetic middle name of the contact.

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
The phonetic name of the organization associated with the contact.

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
A string for the previous family name of the contact.

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 thumbnail version of the contact’s profile picture.

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.


The biggest plugin in space...