Mac Developer Library

Developer

AddressBook Framework Reference Address Book Objective-C Constants Reference

Options
Deployment Target:

On This Page
Language:

Address Book Objective-C Constants Reference

Inheritance


Not Applicable

Conforms To


Not Applicable

Import Statement


Swift

import AddressBook

Objective-C

@import AddressBook;

This document defines constants in the Address Book framework.

Constants

  • The default labels contained in the Address Book database for specifying different values in a multivalue list. Users can also add their own labels.

    Declaration

    Swift

    let kABHomePageLabel: String let kABEmailWorkLabel: String let kABEmailHomeLabel: String let kABEmailMobileMeLabel: String let kABAddressHomeLabel: String let kABAddressWorkLabel: String let kABAnniversaryLabel: String let kABFatherLabel: String let kABMotherLabel: String let kABParentLabel: String let kABBrotherLabel: String let kABSisterLabel: String let kABChildLabel: String let kABFriendLabel: String let kABSpouseLabel: String let kABPartnerLabel: String let kABAssistantLabel: String let kABManagerLabel: String let kABPhoneWorkLabel: String let kABPhoneHomeLabel: String let kABPhoneiPhoneLabel: String let kABPhoneMobileLabel: String let kABPhoneMainLabel: String let kABPhoneHomeFAXLabel: String let kABPhoneWorkFAXLabel: String let kABPhonePagerLabel: String

    Objective-C

    NSString * const kABHomePageLabel; NSString * const kABEmailWorkLabel; NSString * const kABEmailHomeLabel; NSString * const kABEmailMobileMeLabel; NSString * const kABAddressHomeLabel; NSString * const kABAddressWorkLabel; NSString * const kABAnniversaryLabel; NSString * const kABFatherLabel; NSString * const kABMotherLabel; NSString * const kABParentLabel; NSString * const kABBrotherLabel; NSString * const kABSisterLabel; NSString * const kABChildLabel; NSString * const kABFriendLabel; NSString * const kABSpouseLabel; NSString * const kABPartnerLabel; NSString * const kABAssistantLabel; NSString * const kABManagerLabel; NSString * const kABPhoneWorkLabel; NSString * const kABPhoneHomeLabel; NSString * const kABPhoneiPhoneLabel; NSString * const kABPhoneMobileLabel; NSString * const kABPhoneMainLabel; NSString * const kABPhoneHomeFAXLabel; NSString * const kABPhoneWorkFAXLabel; NSString * const kABPhonePagerLabel; NSString * const kABAIMWorkLabel; NSString * const kABAIMHomeLabel; NSString * const kABAIMMobileMeLabel; NSString * const kABJabberWorkLabel; NSString * const kABJabberHomeLabel; NSString * const kABMSNWorkLabel; NSString * const kABMSNHomeLabel; NSString * const kABYahooWorkLabel; NSString * const kABYahooHomeLabel; NSString * const kABICQWorkLabel; NSString * const kABICQHomeLabel;

    Constants

    • kABHomePageLabel

      kABHomePageLabel

      Webpage URL.

      Available in OS X v10.4 and later.

    • kABEmailWorkLabel

      kABEmailWorkLabel

      Work email.

      Available in OS X v10.2 and later.

    • kABEmailHomeLabel

      kABEmailHomeLabel

      Home email.

      Available in OS X v10.2 and later.

    • kABEmailMobileMeLabel

      kABEmailMobileMeLabel

      Mobile Me email.

      Available in OS X v10.6 and later.

    • kABAddressHomeLabel

      kABAddressHomeLabel

      Home address.

      Available in OS X v10.2 and later.

    • kABAddressWorkLabel

      kABAddressWorkLabel

      Work address.

      Available in OS X v10.2 and later.

    • kABAnniversaryLabel

      kABAnniversaryLabel

      Anniversary date.

      Available in OS X v10.3 and later.

    • kABFatherLabel

      kABFatherLabel

      Father.

      Available in OS X v10.3 and later.

    • kABMotherLabel

      kABMotherLabel

      Mother.

      Available in OS X v10.3 and later.

    • kABParentLabel

      kABParentLabel

      Parent.

      Available in OS X v10.3 and later.

    • kABBrotherLabel

      kABBrotherLabel

      Brother.

      Available in OS X v10.3 and later.

    • kABSisterLabel

      kABSisterLabel

      Sister.

      Available in OS X v10.3 and later.

    • kABChildLabel

      kABChildLabel

      Child.

      Available in OS X v10.3 and later.

    • kABFriendLabel

      kABFriendLabel

      Friend.

      Available in OS X v10.3 and later.

    • kABSpouseLabel

      kABSpouseLabel

      Spouse.

      Available in OS X v10.3 and later.

    • kABPartnerLabel

      kABPartnerLabel

      Partner.

      Available in OS X v10.3 and later.

    • kABAssistantLabel

      kABAssistantLabel

      Assistant.

      Available in OS X v10.3 and later.

    • kABManagerLabel

      kABManagerLabel

      Manager.

      Available in OS X v10.3 and later.

    • kABPhoneWorkLabel

      kABPhoneWorkLabel

      Work phone number.

      Available in OS X v10.2 and later.

    • kABPhoneHomeLabel

      kABPhoneHomeLabel

      Home phone number.

      Available in OS X v10.2 and later.

    • kABPhoneiPhoneLabel

      kABPhoneiPhoneLabel

      iPhone phone number.

      Available in OS X v10.6 and later.

    • kABPhoneMobileLabel

      kABPhoneMobileLabel

      Cell phone number.

      Available in OS X v10.2 and later.

    • kABPhoneMainLabel

      kABPhoneMainLabel

      Main phone number.

      Available in OS X v10.2 and later.

    • kABPhoneHomeFAXLabel

      kABPhoneHomeFAXLabel

      Home fax number.

      Available in OS X v10.2 and later.

    • kABPhoneWorkFAXLabel

      kABPhoneWorkFAXLabel

      Work fax number.

      Available in OS X v10.2 and later.

    • kABPhonePagerLabel

      kABPhonePagerLabel

      Pager number.

      Available in OS X v10.2 and later.

    • kABAIMWorkLabel

      kABAIMWorkLabel

      Work AOL instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABWorkLabel and an instant message service of kABInstantMessageServiceAIM instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABAIMHomeLabel

      kABAIMHomeLabel

      Home AOL instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABHomeLabel and an instant message service of kABInstantMessageServiceAIM instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABAIMMobileMeLabel

      kABAIMMobileMeLabel

      Mobile Me AOL instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with an instant message service of kABMobileMeLabel instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABJabberWorkLabel

      kABJabberWorkLabel

      Work Jabber instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABWorkLabel and an instant message service of kABInstantMessageServiceJabber instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABJabberHomeLabel

      kABJabberHomeLabel

      Home Jabber instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABHomeLabel and an instant message service of kABInstantMessageServiceAIM instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABMSNWorkLabel

      kABMSNWorkLabel

      Work MSN instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABWorkLabel and an instant message service of kABInstantMessageServiceMSN instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABMSNHomeLabel

      kABMSNHomeLabel

      Home MSN instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABHomeLabel and an instant message service of kABInstantMessageServiceMSN instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABYahooWorkLabel

      kABYahooWorkLabel

      Work Yahoo instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABWorkLabel and an instant message service of kABInstantMessageServiceYahoo instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABYahooHomeLabel

      kABYahooHomeLabel

      Home Yahoo instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABHomeLabel and an instant message service of kABInstantMessageServiceYahoo instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABICQWorkLabel

      kABICQWorkLabel

      Work ICQ instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABWorkLabel and an instant message service of kABInstantMessageServiceICQ instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABICQHomeLabel

      kABICQHomeLabel

      Home ICQ instant messaging ID.

      Use the multivalue property kABInstantMessageProperty with a label of kABHomeLabel and an instant message service of kABInstantMessageServiceICQ instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

  • The generic labels contained in the Address Book database for specifying different values in a multivalue list. These labels are especially useful if there is no default label for a property. Users can also add their own labels.

    Declaration

    Swift

    let kABWorkLabel: String let kABHomeLabel: String let kABOtherLabel: String let kABMobileMeLabel: String

    Objective-C

    NSString * const kABWorkLabel; NSString * const kABHomeLabel; NSString * const kABOtherLabel; NSString * const kABMobileMeLabel;

    Constants

    • kABWorkLabel

      kABWorkLabel

      All Work labels match this label.

      Available in OS X v10.2 and later.

    • kABHomeLabel

      kABHomeLabel

      All Home labels match this label.

      Available in OS X v10.2 and later.

    • kABOtherLabel

      kABOtherLabel

      All labels other than Home or Work labels match this label.

      Available in OS X v10.2 and later.

    • kABMobileMeLabel

      kABMobileMeLabel

      MobileMe instant messenger or email values.

      Available in OS X v10.7 and later.

  • Properties common to all types of records.

    Declaration

    Swift

    let kABUIDProperty: String let kABCreationDateProperty: String let kABModificationDateProperty: String

    Objective-C

    NSString * const kABUIDProperty; NSString * const kABCreationDateProperty; NSString * const kABModificationDateProperty;

    Constants

    • kABUIDProperty

      kABUIDProperty

      The unique ID for this record. It’s guaranteed never to change, no matter how much the record changes. If you need to store a reference to a record, use this value. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABCreationDateProperty

      kABCreationDateProperty

      The date when the record was first saved. Type: kABDateProperty.

      Available in OS X v10.2 and later.

    • kABModificationDateProperty

      kABModificationDateProperty

      The date when the record was last saved. Type: kABDateProperty.

      Available in OS X v10.2 and later.

  • The properties that a group record contains by default. Developers can add their own properties with the ABGroup method addPropertiesAndTypes:

    Declaration

    Swift

    let kABGroupNameProperty: String

    Objective-C

    NSString * const kABGroupNameProperty;

    Constants

    • kABGroupNameProperty

      kABGroupNameProperty

      Name of the group

      Available in OS X v10.2 and later.

  • The properties that a person record contains by default. Developers can add their own properties with the ABPerson method addPropertiesAndTypes:.

    Declaration

    Swift

    let kABFirstNameProperty: String let kABLastNameProperty: String let kABFirstNamePhoneticProperty: String let kABLastNamePhoneticProperty: String let kABNicknameProperty: String let kABMaidenNameProperty: String let kABBirthdayProperty: String let kABBirthdayComponentsProperty: String let kABOrganizationProperty: String let kABJobTitleProperty: String let kABHomePageProperty: String let kABURLsProperty: String let kABCalendarURIsProperty: String let kABEmailProperty: String let kABAddressProperty: String let kABOtherDatesProperty: String let kABOtherDateComponentsProperty: String let kABRelatedNamesProperty: String let kABDepartmentProperty: String let kABPersonFlags: String let kABPhoneProperty: String let kABInstantMessageProperty: String let kABNoteProperty: String let kABSocialProfileProperty: String let kABMiddleNameProperty: String let kABMiddleNamePhoneticProperty: String let kABTitleProperty: String let kABSuffixProperty: String

    Objective-C

    NSString * const kABFirstNameProperty; NSString * const kABLastNameProperty; NSString * const kABFirstNamePhoneticProperty; NSString * const kABLastNamePhoneticProperty; NSString * const kABNicknameProperty; NSString * const kABMaidenNameProperty; NSString * const kABBirthdayProperty; NSString * const kABBirthdayComponentsProperty; NSString * const kABOrganizationProperty; NSString * const kABJobTitleProperty; NSString * const kABHomePageProperty; NSString * const kABURLsProperty; NSString * const kABCalendarURIsProperty; NSString * const kABEmailProperty; NSString * const kABAddressProperty; NSString * const kABOtherDatesProperty; NSString * const kABOtherDateComponentsProperty; NSString * const kABRelatedNamesProperty; NSString * const kABDepartmentProperty; NSString * const kABPersonFlags; NSString * const kABPhoneProperty; NSString * const kABInstantMessageProperty; NSString * const kABAIMInstantProperty; NSString * const kABJabberInstantProperty; NSString * const kABMSNInstantProperty; NSString * const kABYahooInstantProperty; NSString * const kABICQInstantProperty; NSString * const kABNoteProperty; NSString * const kABSocialProfileProperty; NSString * const kABMiddleNameProperty; NSString * const kABMiddleNamePhoneticProperty; NSString * const kABTitleProperty; NSString * const kABSuffixProperty;

    Constants

    • kABFirstNameProperty

      kABFirstNameProperty

      First name. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABLastNameProperty

      kABLastNameProperty

      Last name. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABFirstNamePhoneticProperty

      kABFirstNamePhoneticProperty

      Phonetic representation of the first name. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABLastNamePhoneticProperty

      kABLastNamePhoneticProperty

      Phonetic representation of the last name. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABNicknameProperty

      kABNicknameProperty

      Nickname. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABMaidenNameProperty

      kABMaidenNameProperty

      Maiden name. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABBirthdayProperty

      kABBirthdayProperty

      Birth date. Type: kABDateProperty.

      Available in OS X v10.2 and later.

    • kABBirthdayComponentsProperty

      kABBirthdayComponentsProperty

      Birth date as date components. Type: kABDateComponentsProperty.

      Available in OS X v10.7 and later.

    • kABOrganizationProperty

      kABOrganizationProperty

      Company name. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABJobTitleProperty

      kABJobTitleProperty

      Job title. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABHomePageProperty

      kABHomePageProperty

      Home web page. Type: kABStringProperty.

      Use kABURLsProperty instead.

      The kABHomePageProperty property has been deprecated in OS X version 10.4. Instead, use the kABURLsProperty multivalue property with the label kABHomePageLabel.

      Available in OS X v10.2 and later.

    • kABURLsProperty

      kABURLsProperty

      Web pages. Type: kABMultiStringProperty.

      Available in OS X v10.4 and later.

    • kABCalendarURIsProperty

      kABCalendarURIsProperty

      Calendar URIs. Type: kABMultiStringProperty.

      Available in OS X v10.5 and later.

    • kABEmailProperty

      kABEmailProperty

      Email addresses. Type: kABMultiStringProperty.

      Available in OS X v10.2 and later.

    • kABAddressProperty

      kABAddressProperty

      Street addresses. Type: kABMultiDictionaryProperty.

      Available in OS X v10.2 and later.

    • kABOtherDatesProperty

      kABOtherDatesProperty

      Dates associated with a person. Type: kABMultiDateProperty.

      Available in OS X v10.3 and later.

    • kABOtherDateComponentsProperty

      kABOtherDateComponentsProperty

      Dates associated with a person, as date components. Type: kABMultiDateComponentsProperty.

      Available in OS X v10.7 and later.

    • kABRelatedNamesProperty

      kABRelatedNamesProperty

      Names of people related to a person. Type: kABMultiStringProperty.

      Available in OS X v10.3 and later.

    • kABDepartmentProperty

      kABDepartmentProperty

      Department name. Type: kABStringProperty.

      Available in OS X v10.3 and later.

    • kABPersonFlags

      kABPersonFlags

      Property that specifies the name ordering and configuration of a record in the Address Book application. See Person Flags.

      Available in OS X v10.3 and later.

    • kABPhoneProperty

      kABPhoneProperty

      Generic phone number. Type: kABMultiStringProperty.

      Available in OS X v10.2 and later.

    • kABInstantMessageProperty

      kABInstantMessageProperty

      Instant messaging ID.

      Available in OS X v10.7 and later.

    • kABAIMInstantProperty

      kABAIMInstantProperty

      AOL instant messaging ID. Type: kABMultiStringProperty.

      Use the multivalue property kABInstantMessageProperty with an instant message service of kABInstantMessageServiceAIM instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABJabberInstantProperty

      kABJabberInstantProperty

      Jabber instant messaging ID. Type: kABMultiStringProperty.

      Use the multivalue property kABInstantMessageProperty with an instant message service of kABInstantMessageServiceJabber instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABMSNInstantProperty

      kABMSNInstantProperty

      MSN instant messaging ID. Type: kABMultiStringProperty.

      Use the multivalue property kABInstantMessageProperty with an instant message service of kABInstantMessageServiceMSN instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABYahooInstantProperty

      kABYahooInstantProperty

      Yahoo instant messaging ID. Type: kABMultiStringProperty.

      Use the multivalue property kABInstantMessageProperty with an instant message service of kABInstantMessageServiceYahoo instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABICQInstantProperty

      kABICQInstantProperty

      ICQ instant messaging ID. Type: kABMultiStringProperty.

      Use the multivalue property kABInstantMessageProperty with an instant message service of kABInstantMessageServiceICQ instead.

      Available in OS X v10.0 and later.

      Deprecated in OS X v10.7.

    • kABNoteProperty

      kABNoteProperty

      Notes. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABSocialProfileProperty

      kABSocialProfileProperty

      Social network profile.

      Available in OS X v10.7 and later.

    • kABMiddleNameProperty

      kABMiddleNameProperty

      Middle name. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABMiddleNamePhoneticProperty

      kABMiddleNamePhoneticProperty

      Phonetic representation of the middle name. Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABTitleProperty

      kABTitleProperty

      Title, such as “Mr.,” “Mrs.,” “General,” “Cardinal,” or “Lord.” Type: kABStringProperty.

      Available in OS X v10.2 and later.

    • kABSuffixProperty

      kABSuffixProperty

      Suffix, such as “Sr.,” “Jr.,” “III.,” or “Esq.” Type: kABStringProperty.

      Available in OS X v10.2 and later.

  • A multivalue property type.

    Declaration

    Swift

    var kABMultiValueMask: Int32 { get }

    Objective-C

    #define kABMultiValueMask 0x100

    Constants

    • kABMultiValueMask

      kABMultiValueMask

      Used by ABPropertyType to specify a multivalue property.

      Available in OS X v10.2 and later.

  • The possible ABPropertyType types for ABRecord properties:

    Declaration

    Objective-C

    enum _ABPropertyType { kABErrorInProperty = 0x0, kABStringProperty = 0x1, kABIntegerProperty = 0x2, kABRealProperty = 0x3, kABDateProperty = 0x4, kABArrayProperty = 0x5, kABDictionaryProperty = 0x6, kABDataProperty = 0x7, kABDateComponentsProperty = 0x8, kABMultiStringProperty = kABMultiValueMask | kABStringProperty, kABMultiIntegerProperty = kABMultiValueMask | kABIntegerProperty, kABMultiRealProperty = kABMultiValueMask | kABRealProperty, kABMultiDateProperty = kABMultiValueMask | kABDateProperty, kABMultiArrayProperty = kABMultiValueMask | kABArrayProperty, kABMultiDictionaryProperty = kABMultiValueMask | kABDictionaryProperty, kABMultiDataProperty = kABMultiValueMask | kABDataProperty kABMultiDateComponentsProperty = kABMultiValueMask | kABDateComponentsProperty };

    Constants

    • kABErrorInProperty

      kABErrorInProperty

      An invalid property was used.

      Available in OS X v10.2 and later.

    • kABStringProperty

      kABStringProperty

      This property is an NSString object.

      Available in OS X v10.2 and later.

    • kABIntegerProperty

      kABIntegerProperty

      This property is an NSNumber object representing an integer.

      Available in OS X v10.2 and later.

    • kABRealProperty

      kABRealProperty

      This property is an NSNumber object representing a real number.

      Available in OS X v10.2 and later.

    • kABDateProperty

      kABDateProperty

      This property is an NSDate object.

      Available in OS X v10.2 and later.

    • kABArrayProperty

      kABArrayProperty

      This property is an NSArray object.

      Available in OS X v10.2 and later.

    • kABDictionaryProperty

      kABDictionaryProperty

      This property is an NSDictionary object.

      Available in OS X v10.2 and later.

    • kABDataProperty

      kABDataProperty

      This property is an NSData object.

      Available in OS X v10.2 and later.

    • kABDateComponentsProperty

      kABDateComponentsProperty

      This property is an NSDateComponents object.

      Available in OS X v10.7 and later.

    • kABMultiStringProperty

      kABMultiStringProperty

      This property is an ABMultiValue object containing NSString objects.

      Available in OS X v10.2 and later.

    • kABMultiIntegerProperty

      kABMultiIntegerProperty

      This property is an ABMultiValue object containing NSNumber objects representing integers.

      Available in OS X v10.2 and later.

    • kABMultiRealProperty

      kABMultiRealProperty

      This property is an ABMultiValue object containing NSNumber objects representing real numbers.

      Available in OS X v10.2 and later.

    • kABMultiDateProperty

      kABMultiDateProperty

      This property is an ABMultiValue object containing NSDate objects.

      Available in OS X v10.2 and later.

    • kABMultiArrayProperty

      kABMultiArrayProperty

      This property is an ABMultiValue object containing NSArray objects.

      Available in OS X v10.2 and later.

    • kABMultiDictionaryProperty

      kABMultiDictionaryProperty

      This property is an ABMultiValue object containing NSDictionary objects.

      Available in OS X v10.2 and later.

    • kABMultiDataProperty

      kABMultiDataProperty

      This property is an ABMultiValue object containing NSData objects.

      Available in OS X v10.2 and later.

    • kABMultiDateComponentsProperty

      kABMultiDateComponentsProperty

      This property is an ABMultiValue object containing NSDateComponents objects.

      Available in OS X v10.7 and later.

  • The keys used to specify the different fields in a kABAddressProperty. Neither developers nor users can add more keys.

    Declaration

    Swift

    let kABAddressStreetKey: String let kABAddressCityKey: String let kABAddressStateKey: String let kABAddressZIPKey: String let kABAddressCountryKey: String let kABAddressCountryCodeKey: String

    Objective-C

    NSString * const kABAddressStreetKey; NSString * const kABAddressCityKey; NSString * const kABAddressStateKey; NSString * const kABAddressZIPKey; NSString * const kABAddressCountryKey; NSString * const kABAddressCountryCodeKey;

    Constants

    • kABAddressStreetKey

      kABAddressStreetKey

      Street.

      Available in OS X v10.2 and later.

    • kABAddressCityKey

      kABAddressCityKey

      City.

      Available in OS X v10.2 and later.

    • kABAddressStateKey

      kABAddressStateKey

      State.

      Available in OS X v10.2 and later.

    • kABAddressZIPKey

      kABAddressZIPKey

      Zip.

      Available in OS X v10.2 and later.

    • kABAddressCountryKey

      kABAddressCountryKey

      Country name.

      This is the field shown in the Contacts application.

      Available in OS X v10.2 and later.

    • kABAddressCountryCodeKey

      kABAddressCountryCodeKey

      Country, identified by ISO country code. For a list of these codes, see Country Codes.

      Available in OS X v10.2 and later.

  • The keys used to specify the different fields in a kABInstantMessageProperty property. Neither developers nor users can add more keys.

    Declaration

    Swift

    let kABInstantMessageUsernameKey: String let kABInstantMessageServiceKey: String

    Objective-C

    NSString * const kABInstantMessageUsernameKey; NSString * const kABInstantMessageServiceKey;

    Constants

    • kABInstantMessageUsernameKey

      kABInstantMessageUsernameKey

      The instant messaging username or handle.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceKey

      kABInstantMessageServiceKey

      The instant messaging service.

      Available in OS X v10.7 and later.

  • The predefined constants are used to identify instant messaging services. You may use these constants or any other string.

    Declaration

    Swift

    let kABInstantMessageServiceAIM: String let kABInstantMessageServiceFacebook: String let kABInstantMessageServiceGaduGadu: String let kABInstantMessageServiceGoogleTalk: String let kABInstantMessageServiceICQ: String let kABInstantMessageServiceJabber: String let kABInstantMessageServiceMSN: String let kABInstantMessageServiceQQ: String let kABInstantMessageServiceSkype: String let kABInstantMessageServiceYahoo: String

    Objective-C

    NSString * const kABInstantMessageServiceAIM; NSString * const kABInstantMessageServiceFacebook; NSString * const kABInstantMessageServiceGaduGadu; NSString * const kABInstantMessageServiceGoogleTalk; NSString * const kABInstantMessageServiceICQ; NSString * const kABInstantMessageServiceJabber; NSString * const kABInstantMessageServiceMSN; NSString * const kABInstantMessageServiceQQ; NSString * const kABInstantMessageServiceSkype; NSString * const kABInstantMessageServiceYahoo;

    Constants

    • kABInstantMessageServiceAIM

      kABInstantMessageServiceAIM

      AOL Instant Messenger instant message service.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceFacebook

      kABInstantMessageServiceFacebook

      Facebook instant message service.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceGaduGadu

      kABInstantMessageServiceGaduGadu

      Gadu-Gadu instant message service.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceGoogleTalk

      kABInstantMessageServiceGoogleTalk

      Google Talk instant message service.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceICQ

      kABInstantMessageServiceICQ

      ICQ instant message service.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceJabber

      kABInstantMessageServiceJabber

      Jabber instant message service.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceMSN

      kABInstantMessageServiceMSN

      MSN instant message service.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceQQ

      kABInstantMessageServiceQQ

      QQ instant message service.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceSkype

      kABInstantMessageServiceSkype

      Skype instant message service.

      Available in OS X v10.7 and later.

    • kABInstantMessageServiceYahoo

      kABInstantMessageServiceYahoo

      Yahoo! instant message service.

      Available in OS X v10.7 and later.

  • The keys used to specify the different fields in a kABSocialProfileProperty property. Neither developers nor users can add more keys.

    Declaration

    Swift

    let kABSocialProfileURLKey: String let kABSocialProfileServiceKey: String let kABSocialProfileUsernameKey: String let kABSocialProfileUserIdentifierKey: String

    Objective-C

    NSString * const kABSocialProfileURLKey; NSString * const kABSocialProfileServiceKey; NSString * const kABSocialProfileUsernameKey; NSString * const kABSocialProfileUserIdentifierKey;

    Constants

    • kABSocialProfileURLKey

      kABSocialProfileURLKey

      Social profile URL.

      Available in OS X v10.7 and later.

    • kABSocialProfileServiceKey

      kABSocialProfileServiceKey

      Social profile service.

      Available in OS X v10.7 and later.

    • kABSocialProfileUsernameKey

      kABSocialProfileUsernameKey

      Social profile username.

      Available in OS X v10.7 and later.

    • kABSocialProfileUserIdentifierKey

      kABSocialProfileUserIdentifierKey

      Social profile user identifier.

      Available in OS X v10.7 and later.

    Discussion

    The value of these constants is undefined until one of the following functions has been called: ABAddressBookCreate, ABPersonCreate, ABGroupCreate.

  • The predefined constants are used to identify social networking services. You may use these constants or any other string.

    Declaration

    Swift

    let kABSocialProfileServiceTwitter: String let kABSocialProfileServiceFacebook: String let kABSocialProfileServiceMySpace: String let kABSocialProfileServiceLinkedIn: String let kABSocialProfileServiceFlickr: String let kABSocialProfileServiceSinaWeibo: String

    Objective-C

    NSString * const kABSocialProfileServiceTwitter; NSString * const kABSocialProfileServiceFacebook; NSString * const kABSocialProfileServiceMySpace; NSString * const kABSocialProfileServiceLinkedIn; NSString * const kABSocialProfileServiceFlickr; NSString * const kABSocialProfileServiceSinaWeibo; NSString * const kABSocialProfileServiceTencentWeibo;

    Constants

    • kABSocialProfileServiceTwitter

      kABSocialProfileServiceTwitter

      Twitter social profile service.

      Available in OS X v10.7 and later.

    • kABSocialProfileServiceFacebook

      kABSocialProfileServiceFacebook

      Facebook social profile service.

      Available in OS X v10.7 and later.

    • kABSocialProfileServiceMySpace

      kABSocialProfileServiceMySpace

      Myspace social profile service.

      Available in OS X v10.7 and later.

    • kABSocialProfileServiceLinkedIn

      kABSocialProfileServiceLinkedIn

      LinkedIn social profile service.

      Available in OS X v10.7 and later.

    • kABSocialProfileServiceFlickr

      kABSocialProfileServiceFlickr

      Flickr social profile service.

      Available in OS X v10.7 and later.

    • kABSocialProfileServiceSinaWeibo

      kABSocialProfileServiceSinaWeibo

      Sina Weibo social profile service.

      Available in OS X v10.8 and later.

    Discussion

    The value of these constants is undefined until one of the following functions has been called: ABAddressBookCreate, ABPersonCreate, ABGroupCreate.

  • Error domains.

    Declaration

    Swift

    let ABAddressBookErrorDomain: String let ABMultiValueIdentifiersErrorKey: String

    Objective-C

    NSString *ABAddressBookErrorDomain; NSString *ABMultiValueIdentifiersErrorKey;

    Constants

    • ABAddressBookErrorDomain

      ABAddressBookErrorDomain

      Error domain returning errors reported by an address book object.

      Available in OS X v10.7 and later.

    • ABMultiValueIdentifiersErrorKey

      ABMultiValueIdentifiersErrorKey

      Key used with ABPropertyValueValidationError. Its value is an array of the identifiers for the values in the multivalue that were invalid.

      Available in OS X v10.7 and later.

  • Errors codes used by the Address Book framework.

    Declaration

    Objective-C

    enum { ABAddRecordsError = 1001, ABRemoveRecordsError = 1002, ABPropertyValueValidationError = 1012, ABPropertyUnsupportedBySourceError = 1013, ABPropertyReadOnlyError = 1014 };

    Constants

    • ABAddRecordsError

      ABAddRecordsError

      The record could not be added.

    • ABRemoveRecordsError

      ABRemoveRecordsError

      The record could not be removed.

    • ABPropertyValueValidationError

      ABPropertyValueValidationError

      The property had an invalid value. See ABMultiValueIdentifiersErrorKey.

    • ABPropertyUnsupportedBySourceError

      ABPropertyUnsupportedBySourceError

      The property is not supported by the source.

    • ABPropertyReadOnlyError

      ABPropertyReadOnlyError

      The property is read-only.