Xojo Developer Conference
25/27th April 2018 in Denver.
MBS Xojo Conference
6/7th September 2018 in Munich, Germany.

Platforms to show: All Mac Windows Linux Cross-Platform

CNContactMBS.areKeysAvailable(keyDescriptors() as CNKeyDescriptorMBS) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: Determines whether all contact property values for the specified keys are fetched.
Notes: The isKeyAvailable or areKeysAvailable methods are used where you are not certain of the keys that when fetched. If this method returns false, refetch the contact using the contact identifier and the keys you want to fetch. Accessing a property that was not fetched will throw an CNContactPropertyNotFetchedExceptionName exception.

Feedback, Comments & Corrections

CNContactMBS.Constructor
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: The private constructor.

Feedback, Comments & Corrections

CNContactMBS.contactRelations as CNLabeledValueMBS()
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: An array of labeled relations for the contact.
Notes: This property is an array of CNLabeledValue objects, each of which has a label and a CNContactRelation value. This property was previously known as related names.

Feedback, Comments & Corrections

CNContactMBS.copy as CNContactMBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: Create a copy of the contact object.

Feedback, Comments & Corrections

CNContactMBS.dates as CNLabeledValueMBS()
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: An array containing labeled Gregorian dates.
Notes: This property is an array of CNLabeledValue objects, each of which has an NSString label and NSDateComponents value. You can use this property to store Gregorian dates such as anniversaries. Day and month components are required 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.

Feedback, Comments & Corrections

CNContactMBS.emailAddresses as CNLabeledValueMBS()
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: An array of labeled email addresses for the contact.
Notes: This property is an array of CNLabeledValue objects, each of which has a label and an NSString that contains the email address.

Feedback, Comments & Corrections

CNContactMBS.instantMessageAddresses as CNLabeledValueMBS()
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: An array of labeled IM addresses for the contact.
Notes: This property is an array of CNLabeledValue objects, each of which has a label and a CNInstantMessageAddress value.

Feedback, Comments & Corrections

CNContactMBS.isKeyAvailable(key as String) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: Determines whether the contact property value for the specified key is fetched.
Notes: The isKeyAvailable or areKeysAvailable methods are used when you are not certain of the keys that were fetched. If this method returns false, refetch the contact using the contact identifier and the keys you want to fetch. Accessing a property that was not fetched will throw CNContactPropertyNotFetchedExceptionName.

Feedback, Comments & Corrections

CNContactMBS.isUnifiedWithContactWithIdentifier(contactIdentifier as String) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: Returns true if the receiver was fetched as a unified contact and includes the contact having contactIdentifier in its unification.

Feedback, Comments & Corrections

CNContactMBS.mutableCopy as CNMutableContactMBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: Creates a mutable copy of this contact.

Feedback, Comments & Corrections

CNContactMBS.phoneNumbers as CNLabeledValueMBS()
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: An array of labeled phone numbers for a contact.
Notes: This property is an array of CNLabeledValue objects, each of which has a label and a CNPhoneNumber value.

Feedback, Comments & Corrections

CNContactMBS.postalAddresses as CNLabeledValueMBS()
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: An array of labeled postal addresses for a contact.
Notes: This property is an array of CNLabeledValue objects, each of which has a label and a CNPostalAddress value.

Feedback, Comments & Corrections

CNContactMBS.socialProfiles as CNLabeledValueMBS()
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: An array of labeled social profiles for a contact.
Notes: This property is an array of CNLabeledValue objects, each of which has a label and a CNSocialProfile value.

Feedback, Comments & Corrections

CNContactMBS.urlAddresses as CNLabeledValueMBS()
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 16.3 Yes No No Yes, macOS only No
Function: An array of labeled URL addresses for a contact.
Notes: This property is an array of CNLabeledValue objects, each of which has a label and an NSString value that contains the URL.

Feedback, Comments & Corrections

CNContactMBS.valueForKey(key as String) as Variant
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Contacts MBS Mac64bit Plugin 17.2 Yes No No Yes, macOS only No
Function: Queries value for a given key.
Example:
// your contact
dim c as CNContactMBS

dim value as Variant = c.valueForKey(c.CNContactPreviousFamilyNameKey)
if value = nil then
// empty
else
MsgBox value.StringValue
end if
Notes: Normally you use the properties, but if you loop over a list of keys, you can use this function to query value for key.

Feedback, Comments & Corrections

The items on this page are in the following plugins: MBS Mac64bit Plugin.




Links
MBS FileMaker Plugins