ABAddressBookMBS.kABRelatedNamesProperty as string

This property is used for persons only.

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants

ABAddressBookMBS.kABSisterLabel as string

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants

ABAddressBookMBS.kABSocialProfileProperty as string

Available on Mac OS X 10.7 or later.
The multi dictionary contains dictionaries. Each has keys like kABSocialProfileURLKey, kABSocialProfileUsernameKey, kABSocialProfileUserIdentifierKey and kABSocialProfileServiceKey.

kABSocialProfileServiceKey has values like kABSocialProfileServiceTwitter, kABSocialProfileServiceFacebook, kABSocialProfileServiceLinkedIn, kABSocialProfileServiceFlickr and kABSocialProfileServiceMySpace.

ABAddressBookMBS.kABSocialProfileServiceFacebook as string

Available on Mac OS X 10.7 or later.
Facebook

ABAddressBookMBS.kABSocialProfileServiceFlickr as string

Available on Mac OS X 10.7 or later.
Flickr

ABAddressBookMBS.kABSocialProfileServiceKey as string

Available on Mac OS X 10.7 or later.
The service for this social profile. Can be kABSocialProfileServiceTwitter, kABSocialProfileServiceFacebook, kABSocialProfileServiceLinkedIn, kABSocialProfileServiceFlickr or kABSocialProfileServiceMySpace.

ABAddressBookMBS.kABSocialProfileServiceLinkedIn as string

Available on Mac OS X 10.7 or later.
LinkedIn

ABAddressBookMBS.kABSocialProfileServiceMySpace as string

MySpace
Available on Mac OS X 10.7 or later.

ABAddressBookMBS.kABSocialProfileServiceSinaWeibo as string

SinaWeibo
Available in Mac OS X 10.8 and newer.

ABAddressBookMBS.kABSocialProfileServiceTencentWeibo as string

Available on Mac OS X 10.9 or later.
Tencent Weibo

ABAddressBookMBS.kABSocialProfileServiceTwitter as string

Available on Mac OS X 10.7 or later.
Twitter

ABAddressBookMBS.kABSocialProfileServiceYelp as string

Available on Mac OS X 10.7 or later.
Yelp

ABAddressBookMBS.kABSocialProfileURLKey as string

Available on Mac OS X 10.7 or later.
Service name. Possible values follow.

ABAddressBookMBS.kABSocialProfileUserIdentifierKey as string

Available on Mac OS X 10.7 or later.
Service-specific identifier.

ABAddressBookMBS.kABSocialProfileUsernameKey as string

Available on Mac OS X 10.7 or later.
User-visible profile name.

ABAddressBookMBS.kABSpouseLabel as string

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants

ABAddressBookMBS.kABSuffixProperty as string

e.g. "Sr." "Jr." "III"
This property is used for persons only.

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants

ABAddressBookMBS.kABTitleProperty as string

e.g. "Sir" "Duke" "General" "Lord"
This property is used for persons only.

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants

ABAddressBookMBS.kABUIDProperty as string

A property for all records.

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants
• /MacCocoa/Addressbook/Edit Distance values
• /MacCocoa/Addressbook/Extract Vcard
• /MacCocoa/Addressbook/List Addresses
• /MacCocoa/Addressbook/Search Person

ABAddressBookMBS.kABUpdatedRecords as string

Records that have been updated.

ABAddressBookMBS.kABURLsProperty as string

// shows all websites with labels

dim a as new ABAddressBookMBS
dim p as ABPersonMBS = a.owner
dim m as ABMultiValueMBS = p.valueForProperty(a.kABURLsProperty)

dim u as Integer = m.count-1
for i as Integer = 0 to u
  dim label as string = m.labelAtIndex(i)
  dim value as string = m.valueAtIndex(i)
  
  MsgBox label+" -> "+value
next

This property is used for persons only.

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants
• /MacCocoa/Addressbook/Show my entry

ABAddressBookMBS.kABWorkLabel as string

All kABXXXXWorkLabel are equivalent to this label

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants
• /MacCocoa/Addressbook/Show my entry

ABAddressBookMBS.kABYahooHomeLabel as string

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants

ABAddressBookMBS.kABYahooInstantProperty as string

This property is used for persons only.
Deprecated in Mac OS 10.7. You should use kABInstantMessageProperty.

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants

ABAddressBookMBS.kABYahooWorkLabel as string

Some examples using this method:

• /MacCocoa/Addressbook/Addressbook Constants

ABAddressBookMBS.searchElementForConjunction(conjunction as Integer, children() as ABSearchElementMBS) as ABSearchElementMBS

Convenience function which can be used instead of ABSearchElementMBS.searchElementForConjunction.

ABAddressBookMBS.searchElementForGroupProperty(PropertyName as string, Label as string, Key as string, value as Variant, comparison as Integer) as ABSearchElementMBS

Convenience function to be used instead of the searchElementForProperty method in the ABGroupMBS class.

ABAddressBookMBS.searchElementForPersonProperty(PropertyName as string, Label as string, Key as string, value as Variant, comparison as Integer) as ABSearchElementMBS

// search person by record's unique ID
// this is same as calling recordForUniqueId function directly
dim a as new ABAddressBookMBS
dim e as ABSearchElementMBS

dim PropertyName as string = a.kABUIDProperty
const Label = ""
const Key = ""
const value = "637FA922-7A2B-4F9A-BFA3-023253D4A3D5:ABPerson" // some person ID
const comparison = a.kABEqual

e = ABPersonMBS.searchElementForProperty(PropertyName, label, key, value, comparison)

dim records() as ABRecordMBS = a.recordsMatchingSearchElement(e)

for each r as ABRecordMBS in records
  dim p as ABPersonMBS = ABPersonMBS(r)
  
  MsgBox p.DisplayName
next

Convenience function to be used instead of the searchElementForProperty method in the ABPersonMBS class.

Some examples using this method:

• /MacCocoa/Addressbook/Add person
• /MacCocoa/Addressbook/Easy search
• /MacCocoa/Addressbook/Search Person

ABAddressBookMBS.sharedAddressbook as ABAddressBookMBS

// quickly find the addressbook, locate me and display my name:
MsgBox ABAddressBookMBS.sharedAddressbook.owner.DisplayName

If you call this method several times, the object is cached, so it's only created the first time (singleton).
Returns nil on Windows or Linux or low memory or missing permissions.

Some examples using this method:

• /MacCocoa/Addressbook/GroupsForAccounts Test
• /MacFrameworks/Query Adressbook Permissions in background
• /Util/BugreporterKit/BugReporter
• /Util/BugreporterKit/BugReporter Console

ABAddressBookMBS.sharedAddressbookMT as ABAddressBookMBS

On Mac OS X 10.8, the user will be asked to allow access to the addressbook for your application. As the call to sharedAddressbook blocks in this case, this method can be called on a thread to avoid the blocking of your app.

If you call this method several times, the object is cached, so it's only created the first time (singleton).
Returns nil on Windows or Linux or low memory or missing permissions.

The work is performed on a preemptive thread, so this function does not block the application and can yield time to other Xojo threads. Must be called in a Xojo thread to enjoy benefits. If called in main thread will block, but keep other background threads running.

Some examples using this method:

• /MacFrameworks/Query Adressbook Permissions in background