Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка платформы AddressBook ссылка класса ABRecord

Опции
Развертывание Target:

На этой странице
Язык:

ABRecord

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

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

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

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

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

Swift

import AddressBook

Objective C

@import AddressBook;

Доступность

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

Инициализация записей
  • init (addressBook:) - initWithAddressBook:

    Инициализирует запись с помощью данной адресной книги.

    Объявление

    Swift

    init!(addressBook addressBook: ABAddressBook!)

    Objective C

    - (id)initWithAddressBook:(ABAddressBook *)addressBook

    Параметры

    addressBook

    Адресная книга, с которой можно инициализировать запись.

    Обсуждение

    Запись добавляется к addressBook но не видимо к другим адресным книгам до addressBook сохраняется. Этот метод является определяемым инициализатором для этого класса.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

  • init () - init

    Инициализирует запись с помощью совместно используемой адресной книги.

    Объявление

    Swift

    init!()

    Objective C

    - (id)init

    Обсуждение

    На OS X v10.5 и позже, это эквивалентно initWithAddressBook:[ABAddressBook addressBook].

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

Получение и установка значений
  • removeValueForProperty (_:) - removeValueForProperty:

    Удаляет значение для данного свойства.

    Объявление

    Swift

    func removeValueForProperty(_ property: String!) -> Bool

    Objective C

    - (BOOL)removeValueForProperty:(NSString *)property

    Параметры

    property

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

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

    YEStrue если значение удалено успешно; иначе, NOfalse.

    Обсуждение

    Когда Вы затем вызываете valueForProperty: на том свойстве это возвращается nil.

    Если свойство nil, этот метод повышает исключение.

    Для списка доступных свойств посмотрите Записи Адресной книги Доступа в Руководстве по программированию Адресной книги для Mac.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

  • setValue (_: forProperty:) - setValue:forProperty:

    Устанавливает значение данного свойства для записи.

    Объявление

    Swift

    func setValue(_ value: AnyObject!, forProperty property: String!) -> Bool

    Objective C

    - (BOOL)setValue:(id)value forProperty:(NSString *)property

    Параметры

    value

    Значение для установки для property.

    property

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

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

    YEStrue если значение было установлено успешно; иначе, NOfalse.

    Обсуждение

    Тип значения должен соответствовать тип свойства (см. Типы Свойства для списка возможных типов свойства). Если property nil или если value не имеет корректного типа, этот метод повышает исключение. Если property свойство списка мультизначения, этот метод проверки, чтобы видеть, являются ли значения в списке мультизначения тем же типом. Если список мультизначения будет содержать смешанные типы, то значение не будет установлено успешно.

    Для списка доступных свойств посмотрите Записи Адресной книги Доступа в Руководстве по программированию Адресной книги для Mac.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

  • setValue (_: forProperty:error:) - setValue:forProperty:error:

    Устанавливает значение данного свойства для записи, возвращая информацию об ошибке.

    Объявление

    Swift

    func setValue(_ value: AnyObject!, forProperty property: String!, error error: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)setValue:(id)value forProperty:(NSString *)property error:(NSError **)error

    Параметры

    value

    Значение для установки для property.

    property

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

    error

    Указатель на ошибочный объект, установленный в NSError экземпляр, если происходит ошибка.

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

    YEStrue если значение было установлено успешно; иначе, NOfalse.

    Обсуждение

    Тип значения должен соответствовать тип свойства (см. Типы Свойства для списка возможных типов свойства). Если property nil или если value не имеет корректного типа, этот метод повышает исключение. Если property свойство списка мультизначения, этот метод проверки, чтобы видеть, являются ли значения в списке мультизначения тем же типом. Если список мультизначения будет содержать смешанные типы, то значение не будет установлено успешно.

    Для списка доступных свойств посмотрите Записи Адресной книги Доступа в Руководстве по программированию Адресной книги для Mac.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

  • valueForProperty (_:) - valueForProperty:

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

    Объявление

    Swift

    func valueForProperty(_ property: String!) -> AnyObject!

    Objective C

    - (id)valueForProperty:(NSString *)property

    Параметры

    property

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

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

    Значение данного свойства.

    Обсуждение

    Тип значения зависит от типа свойства (см. Типы Свойства для списка возможных типов свойства). Обратите внимание на то, что возвращенное значение всегда имеет неизменный тип (например, NSString введите, не NSMutableString введите, возвращается).

    Если property nil, этот метод повышает исключение. Если property недопустимо, этот метод возвраты nil.

    Для списка доступных свойств посмотрите Записи Адресной книги Доступа в Руководстве по программированию Адресной книги для Mac.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

Получение определенной записи
  • isReadOnly () - isReadOnly

    Возвраты, только ли запись для чтения.

    Объявление

    Swift

    func isReadOnly() -> Bool

    Objective C

    - (BOOL)isReadOnly

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

    YEStrue если запись только для чтения; иначе, NOfalse.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

Определение свойств
  • uniqueId - uniqueId

    Возвращает уникальный идентификатор для записи.

    Объявление

    Swift

    var uniqueId: String! { get }

    Objective C

    @property(readonly, copy) NSString *uniqueId

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

    Уникальный идентификатор.

    Обсуждение

    Этот метод эквивалентен вызову valueForProperty:, передача kABUIDProperty как параметр.

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

    Objective C

    @import AddressBook;

    Swift

    import AddressBook

    Доступность

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

    См. также

    – recordForUniqueId:(ABAddressBook)