Platforms to show: All Mac Windows Linux Cross-Platform
CNContactMBS.birthday as NSDateComponentsMBS
Function:
A date component for the Gregorian birthday of the contact.
Notes:
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Notes:
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
Function:
An enum identifying the contact type.
Notes:
Can be CNContactMBS.CNContactTypeOrganization or CNContactMBS.CNContactTypePerson.
(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 |
Notes:
Can be CNContactMBS.CNContactTypeOrganization or CNContactMBS.CNContactTypePerson.
(Read only property)
CNContactMBS.departmentName as String
Function:
The name of the department associated with the contact.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.familyName as String
Function:
The family name of the contact.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.givenName as String
Function:
The given name of the contact.
Notes:
The given name is often known as the first name of the contact.
(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 |
Notes:
The given name is often known as the first name of the contact.
(Read only property)
CNContactMBS.Handle as Integer
Function:
The internal object reference.
Notes:
Value is a pointer to a CNContact object.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Notes:
Value is a pointer to a CNContact object.
(Read and Write property)
CNContactMBS.identifier as String
Function:
A value that uniquely identifies a contact on the device.
Notes:
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Notes:
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
Function:
The profile picture of a contact.
Notes:
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Notes:
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
Function:
Indicates whether a contact has a profile picture.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.jobTitle as String
Function:
The contact’s job title.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.middleName as String
Function:
The middle name of the contact.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.namePrefix as String
Function:
The name prefix of the contact.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.nameSuffix as String
Function:
The name suffix of the contact.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.nickname as String
Function:
The nickname of the contact.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.nonGregorianBirthday as NSDateComponentsMBS
Function:
A date component for the non-Gregorian birthday of the contact.
Notes:
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 |
Notes:
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
Function:
A string containing notes for the contact.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.organizationName as String
Function:
The name of the organization associated with the contact.
Notes: (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 |
Notes: (Read only property)
CNContactMBS.phoneticFamilyName as String
Function:
A string for the phonetic family name of the contact.
Notes:
This property contains a string that specifies the pronunciation of the contact’s family (or last) name.
(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 |
Notes:
This property contains a string that specifies the pronunciation of the contact’s family (or last) name.
(Read only property)
CNContactMBS.phoneticGivenName as String
Function:
The phonetic given name of the contact.
Notes:
This property contains a string that specifies the pronunciation of the contact’s given (or first) name.
(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 |
Notes:
This property contains a string that specifies the pronunciation of the contact’s given (or first) name.
(Read only property)
CNContactMBS.phoneticMiddleName as String
Function:
The phonetic middle name of the contact.
Notes:
This property contains a string that specifies the pronunciation of the contact’s middle name.
(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 |
Notes:
This property contains a string that specifies the pronunciation of the contact’s middle name.
(Read only property)
CNContactMBS.phoneticOrganizationName as String
Function:
The phonetic name of the organization associated with the contact.
Notes:
This property contains a string that specifies the pronunciation of the contact’s organization name.
Requires macOS 10.12 or newer.
(Read only property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 20.5 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Notes:
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
Function:
A string for the previous family name of the contact.
Notes:
The previous family name is often known as the maiden name of the contact.
(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 |
Notes:
The previous family name is often known as the maiden name of the contact.
(Read only property)
CNContactMBS.thumbnailImageData as MemoryBlock
Function:
The thumbnail version of the contact’s profile picture.
Notes:
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)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | Contacts | MBS Mac64bit Plugin | 16.3 | ✅ Yes | ❌ No | ❌ No | ✅ Yes | Desktop & iOS |
Notes:
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.
Links
MBS Xojo Plugins
