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

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

Разработчик

Ссылка платформы основы ссылка на протокол NSScriptKeyValueCoding

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

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

NSScriptKeyValueCoding

Сценарии какао используют в своих интересах кодирование значения ключа, чтобы получить и установить информацию в scriptable объектах. Методы в этой категории обеспечивают дополнительные возможности работы с кодированием значения ключа, включая получение и установку значений ключа индексом в ключах мультизначения и принуждении (или преобразование) значение ключа. Дополнительные методы позволяют лицу, осуществляющему внедрение scriptable контейнерного класса обеспечивать быстрый доступ к элементам, на которые ссылаются по имени и уникальный идентификатор.

Поскольку сценарии Какао вызывают setValue:forKey: и mutableArrayValueForKey:, изменения в объектах модели, сделанных сценариями AppleScript, являются заметным использующим автоматическим наблюдением значения ключа.

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

Не применимый

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

Не применимый

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

Swift

import Foundation

Objective C

@import Foundation;

Доступность

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

Индексный доступ
  • insertValue (_: atIndex:inPropertyWithKey:) - insertValue:atIndex:inPropertyWithKey:

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

    Объявление

    Swift

    func insertValue(_ value: AnyObject, atIndex index: Int, inPropertyWithKey key: String)

    Objective C

    - (void)insertValue:(id)value atIndex:(NSUInteger)index inPropertyWithKey:(NSString *)key

    Обсуждение

    Метод insertIn<Key>:atIndex: вызывается, если это существует. Если никакой соответствующий scripting-KVC-compliant метод (insertIn<Key>:atIndex: ) найден, этот метод вызывает mutableArrayValueForKey: и видоизменяет результат.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • removeValueAtIndex (_: fromPropertyWithKey:) - removeValueAtIndex:fromPropertyWithKey:

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

    Объявление

    Swift

    func removeValueAtIndex(_ index: Int, fromPropertyWithKey key: String)

    Objective C

    - (void)removeValueAtIndex:(NSUInteger)index fromPropertyWithKey:(NSString *)key

    Обсуждение

    Метод removeFrom<Key>AtIndex: вызывается, если это существует. Если никакой соответствующий scripting-KVC-compliant метод (-removeFrom<Key>AtIndex:) найден, этот метод вызывает -mutableArrayValueForKey: и видоизменяет результат.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • replaceValueAtIndex (_: inPropertyWithKey:withValue:) - replaceValueAtIndex:inPropertyWithKey:withValue:

    Заменяет объект в указанном индексе в наборе, указанном переданным ключом.

    Объявление

    Swift

    func replaceValueAtIndex(_ index: Int, inPropertyWithKey key: String, withValue value: AnyObject!)

    Objective C

    - (void)replaceValueAtIndex:(NSUInteger)index inPropertyWithKey:(NSString *)key withValue:(id)value

    Обсуждение

    Метод replaceIn<Key>:atIndex: вызывается, если это существует. Если никакой соответствующий scripting-KVC-compliant метод (-replaceIn<Key>atIndex:) найден, этот метод вызывает -mutableArrayValueForKey: и видоизменяет результат.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • valueAtIndex (_: inPropertyWithKey:) - valueAtIndex:inPropertyWithKey:

    Получает индексируемый объект от набора, указанного переданным ключом.

    Объявление

    Swift

    func valueAtIndex(_ index: Int, inPropertyWithKey key: String) -> AnyObject?

    Objective C

    - (id)valueAtIndex:(NSUInteger)index inPropertyWithKey:(NSString *)key

    Обсуждение

    Это фактически работает с ключом единственного значения также если index 0. Метод valueIn<Key>AtIndex: используется, если это существует.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Доступ по имени, ключ или ID
  • insertValue (_: inPropertyWithKey:) - insertValue:inPropertyWithKey:

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

    Объявление

    Swift

    func insertValue(_ value: AnyObject!, inPropertyWithKey key: String!)

    Objective C

    - (void)insertValue:(id)value inPropertyWithKey:(NSString *)key

    Обсуждение

    Метод insertIn<Key>: используется, если это существует. Иначе, повышения NSUndefinedKeyException. Это - часть поддержки сценариев Какао вставки недавно-созданных-объектов в контейнеры, явно не указывая расположение.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • valueWithName (_: inPropertyWithKey:) - valueWithName:inPropertyWithKey:

    Получает именованный объект от набора, указанного переданным ключом.

    Объявление

    Swift

    func valueWithName(_ name: String!, inPropertyWithKey key: String!) -> AnyObject!

    Objective C

    - (id)valueWithName:(NSString *)name inPropertyWithKey:(NSString *)key

    Обсуждение

    Метод valueIn<Key>WithName: используется, если это существует. Иначе, повышения NSUndefinedKeyException.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

  • valueWithUniqueID (_: inPropertyWithKey:) - valueWithUniqueID:inPropertyWithKey:

    Получает объект ID от набора, указанного переданным ключом.

    Объявление

    Swift

    func valueWithUniqueID(_ uniqueID: AnyObject!, inPropertyWithKey key: String!) -> AnyObject!

    Objective C

    - (id)valueWithUniqueID:(id)uniqueID inPropertyWithKey:(NSString *)key

    Обсуждение

    Метод valueIn<Key>WithUniqueID: вызывается, если это существует. Иначе, повышения NSUndefinedKeyException. Заявленный тип uniqueID в созданном методе должен быть id, NSNumber *, NSString *, или один из скалярных типов, которые могут инкапсулироваться NSNumber.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Приведение
  • coerceValue (_: forKey:) - coerceValue:forKey:

    Использование вводит информацию из описания класса и NSScriptCoercionHandler попытаться преобразовать value для key к надлежащему типу, при необходимости.

    Объявление

    Swift

    func coerceValue(_ value: AnyObject!, forKey key: String!) -> AnyObject!

    Objective C

    - (id)coerceValue:(id)value forKey:(NSString *)key

    Обсуждение

    Метод coerceValueFor<Key>: используется, если это существует.

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

    Objective C

    @import Foundation;

    Swift

    import Foundation

    Доступность

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

Константы
  • Имена исключения NSScriptKeyValueCoding

    NSScriptKeyValueCoding определяет следующее исключение.

    Объявление

    Swift

    var NSOperationNotSupportedForKeyException: NSString!

    Objective C

    extern NSString *NSOperationNotSupportedForKeyException;

    Константы

    • NSOperationNotSupportedForKeyException

      NSOperationNotSupportedForKeyException

      Может быть повышен методами кодирования значения ключа, хотящими явно запретить определенные манипуляции или доступы.

      Например, a setKey: метод для ключа только для чтения может повысить это исключение.

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