АБПЕРСОН

ABPerson класс инкапсулирует всю информацию о лице в базе данных Address Book — экземпляр ABPerson соответствует единственной записи лица в базе данных. ABPerson класс определяет свойства, такие как имя лица, компания, адрес, адреса электронной почты и телефонные номера.

ABPerson класс “бесплатный соединенный мостом” с его процедурным дубликатом непрозрачного типа C. Это означает что ABPersonRef тип является взаимозаменяемым в вызовах функции или вызовах метода с экземплярами ABPerson класс.

Наследование

NSObject
ABRecord
ABPerson

NSObject
ABRecord
ABPerson

Соответствует

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

Оператор импорта

Swift

import AddressBook

Objective C

@import AddressBook;

Доступность

Доступный в OS X v10.2 и позже.

Управление свойствами

addPropertiesAndTypes (_:) + addPropertiesAndTypes:

Добавляют данные свойства ко всем записям этого типа в базе данных Address Book.

Объявление

Swift

class func addPropertiesAndTypes(_ properties: [NSObject : AnyObject]!) -> Int

Objective C

+ (NSInteger)addPropertiesAndTypes:(NSDictionary *)properties

Параметры

properties

Словарь свойств для добавления, и их типы.

Возвращаемое значение

Число свойств успешно добавило, или -1 если происходит ошибка.

Обсуждение

В каждой словарной статье ключ является строкой с именем свойства, и значение является константой с типом свойства. Имя свойства должно быть уникальным. Можно хотеть использовать имена пакета стиля Java для свойств, например, org.dogclub.dogname или com.mycompany.customerID. Тип свойства должен быть одной из констант, описанных в Типах Свойства.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.
removeProperties (_:) + removeProperties:

Удаляет данные свойства из всех записей этого типа в базе данных Address Book.

Объявление

Swift

class func removeProperties(_ properties: [AnyObject]!) -> Int

Objective C

+ (NSInteger)removeProperties:(NSArray *)properties

Параметры

properties

Массив свойств для удаления.

Возвращаемое значение

Число свойств, успешно удаленных, или -1 если происходит ошибка.

Обсуждение

Только пользовательские свойства могут быть удалены. Этот метод не реализован.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.
свойства () + свойства

Возвращает массив имен всех свойств для записи в базе данных Address Book.

Объявление

Swift

class func properties() -> [AnyObject]!

Objective C

+ (NSArray *)properties

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

См. также

+ typeOfProperty:
typeOfProperty (_:) + typeOfProperty:

Возвращает тип данного свойства.

Объявление

Swift

class func typeOfProperty(_ property: String!) -> ABPropertyType

Objective C

+ (ABPropertyType)typeOfProperty:(NSString *)property

Параметры

property

Свойство, тип которого будет возвращен.

Обсуждение

Если свойство не существует, этот метод возвраты kABErrorInProperty.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

См. также

+ свойства

Управление соединенными людьми

linkedPeople () - linkedPeople

Возвращает массив всех записей лица, соединяющихся с лицом, которое представляет эта запись.

Объявление

Swift

func linkedPeople() -> [AnyObject]!

Objective C

- (NSArray *)linkedPeople

Возвращаемое значение

Массив всех записей лица, соединяющихся с лицом эта запись, представляет.

Обсуждение

Соединенные записи содержат информацию о том же лице, и обычно прибывают из других источников.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.8 и позже.

Managing Groups

parentGroups () - parentGroups

Возвращает массив групп адресной книги, которым принадлежит это лицо.

Объявление

Swift

func parentGroups() -> [AnyObject]!

Objective C

- (NSArray *)parentGroups

Обсуждение

Если лицо не принадлежит никаким группам, этот метод возвращает пустой массив.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

Управление изображениями

cancelLoadingImageDataForTag (_:) + cancelLoadingImageDataForTag:

Отменяет асинхронную выборку изображений для данного тега.

Объявление

Swift

class func cancelLoadingImageDataForTag(_ tag: Int)

Objective C

+ (void)cancelLoadingImageDataForTag:(NSInteger)tag

Параметры

tag

Тег асинхронной выборки, которая будет отменена.

Обсуждение

Тег возвращается от предыдущего вызова до beginLoadingImageDataForClient: метод, запустивший асинхронную выборку.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

См. также

– beginLoadingImageDataForClient:
consumeImageData:forTag: (ABImageClient)


    
    beginLoadingImageDataForClient (_:)
    - beginLoadingImageDataForClient:

Запускает асинхронную выборку для данных изображения во всех расположениях

Объявление

Swift

func beginLoadingImageDataForClient(_ client: ABImageClient!) -> Int

Objective C

- (NSInteger)beginLoadingImageDataForClient:(id<ABImageClient>)client

Параметры


      client

Объект, который будет уведомлен, когда изображение заканчивает загружаться.

Возвращаемое значение

Ненулевой тег для отслеживания. Этот тег используется cancelLoadingImageDataForTag: метод для отмены работы выборки.

Обсуждение

client объект должен соответствовать ABImageClient протокол. A consumeImageData:forTag: сообщение отправляется в client когда сделана выборка. Используйте cancelLoadingImageDataForTag: метод, если необходимо отменить асинхронную выборку.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

См. также

– imageData

imageData () - imageData

Данные возвратов, содержащие изображение этого лица.

Объявление

Swift

func imageData() -> NSData!

Objective C

- (NSData *)imageData

Возвращаемое значение

Данные, содержащие изображение этого лица

Обсуждение

Этот метод ищет только локальную файловую систему и работает синхронно. Чтобы выполнить асинхронный поиск или искать по сети, использовать beginLoadingImageDataForClient:.

Возвращенные данные находятся в совместимом формате QuickTime. Для создания изображения из него используйте NSImage метод initWithData:.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

См. также

– beginLoadingImageDataForClient:
– setImageData:
setImageData (_:) - setImageData:

Устанавливает изображение для этого лица к определенным данным.

Объявление

Swift

func setImageData(_ data: NSData!) -> Bool

Objective C

- (BOOL)setImageData:(NSData *)data

Параметры

data

Изображение, которое будет установлено.

Обсуждение

data параметр должен быть в совместимом формате QuickTime. Передача nil указать, что нет никакого изображения для этого лица.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

См. также

– imageData
– beginLoadingImageDataForClient:

Поиск


    
    searchElementForProperty (_: label:key:value:comparison:)
    + searchElementForProperty:label:key:value:comparison:

Возвращает поисковый объект элемента, указывающий запрос для записей этого типа.

Объявление

Swift

class func searchElementForProperty(_ property: String!, label label: String!, key key: String!, value value: AnyObject!, comparison comparison: ABSearchComparison) -> ABSearchElement!

Objective C

+ (ABSearchElement *)searchElementForProperty:(NSString *)property label:(NSString *)label key:(NSString *)key value:(id)value comparison:(ABSearchComparison)comparison

Параметры

`property`	Имя свойства для поиска на, такой как `kABAddressProperty` или `kABLastNameProperty`. Это имя не может быть `nil`. Для полного списка свойств посмотрите Рекордные Свойства По умолчанию и Свойства Лица По умолчанию.
`label`	Имя метки для списка мультизначения, такой как `kABAddressHomeLabel`, `kABPhoneWorkLabel`, или указанная пользователями метка, такой как `Summer Home`. Если указанное свойство не имеет многократных значений, передачи `nil`. Если указанное свойство действительно имеет многократные значения, передачу `nil` искать все значения. Для полного списка имен метки посмотрите Метки Списка Мультизначения По умолчанию и Универсальные Метки Списка Мультизначения.
`key`	Ключевое имя для словаря, такой как `kABAddressCityKey` или `kABAddressStreetKey`. Если указанное свойство не является словарем, передачей `nil`. Если указанное свойство является словарем, передачей `nil` искать все ключи. Для полного списка ключевых имен посмотрите Ключи Адреса.
`value`	Что Вы ищете. Если `nil`, тогда единственное поддерживаемое значение для `comparison` `kABEqual` или `kABNotEqual`.
`comparison`	Тип сравнения для выполнения, такой как `kABEqual` или `kABPrefixMatchCaseInsensitive`.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

См. также

searchElementForProperty:label:key:value:comparison: (ABGroup)
searchElementForConjunction:children: (ABSearchElement)
recordsMatchingSearchElement: (ABAddressBook)

Импорт и Экспорт vCard Отформатированные Файлы

init (VCardRepresentation:) - initWithVCardRepresentation:

Возвраты ABPerson экземпляр инициализируется с определенными данными.

Объявление

Swift

init!(VCardRepresentation vCardData: NSData!)

Objective C

- (id)initWithVCardRepresentation:(NSData *)vCardData

Параметры

vCardData

Объект данных, содержащий vCard представление записи лица.

Возвращаемое значение

ABPerson экземпляр инициализируется с определенными данными.

Обсуждение

Версия 2.1 и 3.0 формата vCard поддерживается. Если vCardData nil или не допустимый формат vCard, этот метод возвраты nil.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

См. также

– vCardRepresentation
vCardRepresentation () - vCardRepresentation

Возвращает vCard представление записи лица как объект данных в формате vCard.

Объявление

Swift

func vCardRepresentation() -> NSData!

Objective C

- (NSData *)vCardRepresentation

Возвращаемое значение

Объект данных, содержащий vCard представление записи лица.

Оператор импорта

Objective C

@import AddressBook;

Swift

import AddressBook

Доступность

Доступный в OS X v10.2 и позже.

См. также

– initWithVCardRepresentation:

Константы

Флаги лица
Настройки, определяющие, как записи лица выведены на экран.

Объявление

Swift

var kABShowAsMask: Int32 { get } var kABShowAsPerson: Int32 { get } var kABShowAsCompany: Int32 { get } var kABShowAsResource: Int32 { get } var kABShowAsRoom: Int32 { get } var kABNameOrderingMask: Int32 { get } var kABDefaultNameOrdering: Int32 { get } var kABFirstNameFirst: Int32 { get } var kABLastNameFirst: Int32 { get }

Objective C

#define kABShowAsMask 000007 #define kABShowAsPerson 000000 #define kABShowAsCompany 000001 #define kABShowAsResource 000002 #define kABShowAsRoom 000003 #define kABNameOrderingMask 000070 #define kABDefaultNameOrdering 000000 #define kABFirstNameFirst 000040 #define kABLastNameFirst 000020

Константы
- kABShowAsMask
  
  kABShowAsMask
  
  Используемый в сочетании с kABShowAsPerson, kABShowAsCompany, kABShowAsResource, и kABShowAsRoom определить рекордную конфигурацию.
  
  Доступный в OS X v10.3 и позже.
- kABShowAsPerson
  
  kABShowAsPerson
  
  Запись выведена на экран как лицо.
  
  Доступный в OS X v10.3 и позже.
- kABShowAsCompany
  
  kABShowAsCompany
  
  Запись выведена на экран как компания.
  
  Доступный в OS X v10.3 и позже.
- kABShowAsResource
  
  kABShowAsResource
  
  Запись выведена на экран как ресурс.
  
  Доступный в OS X v10.6 и позже.
- kABShowAsRoom
  
  kABShowAsRoom
  
  Запись выведена на экран как комната.
  
  Доступный в OS X v10.6 и позже.
- kABNameOrderingMask
  
  kABNameOrderingMask
  
  Используемый в сочетании с kABDefaultNameOrdering, kABFirstNameFirst, и kABLastNameFirst определить упорядочивание имени.
  
  Доступный в OS X v10.3 и позже.
- kABDefaultNameOrdering
  
  kABDefaultNameOrdering
  
  Упорядочивание имени по умолчанию (выведены ли имя лица или фамилия на экран сначала), приложение Адресной книги.
  
  Доступный в OS X v10.3 и позже.
- kABFirstNameFirst
  
  kABFirstNameFirst
  
  Имя выведено на экран сначала в Адресной книге.
  
  Доступный в OS X v10.3 и позже.
- kABLastNameFirst
  
  kABLastNameFirst
  
  Фамилия выведена на экран сначала в Адресной книге.
  
  Доступный в OS X v10.3 и позже.