NSScriptKeyValueCoding

A collection of methods that provide additional capabilities for working with key-value coding. キー値コーディングを扱うための追加能力を提供するメソッドのいちコレクション。

Overview 概要

Cocoa scripting takes advantage of key-value coding to get and set information in scriptable objects. Cocoaスクリプティングは、「キー値」コーディングを利用して、スクリプト対応オブジェクの中の情報を取得及び設定します。 The methods in this category provide additional capabilities for working with key-value coding, including getting and setting key values by index in multi-value keys and coercing (or converting) a key value. Additional methods allow the implementer of a scriptable container class to provide fast access to elements that are being referenced by name and unique ID.

Because Cocoa scripting invokes setValue(_:forKey:) and mutableArrayValue(forKey:), changes to model objects made by AppleScript scripts are observable using automatic key-value observing.

Topics 話題

Indexed access

func insertValue(Any, at: Int, inPropertyWithKey: String)
Inserts an object at the specified index in the collection specified by the passed key.
func removeValue(at: Int, fromPropertyWithKey: String)
Removes the object at the specified index from the collection specified by the passed key.
func replaceValue(at: Int, inPropertyWithKey: String, withValue: Any)
Replaces the object at the specified index in the collection specified by the passed key.
func value(at: Int, inPropertyWithKey: String) -> Any?
Retrieves an indexed object from the collection specified by the passed key.

Access by name, key, or ID

func insertValue(Any, inPropertyWithKey: String)
Inserts an object in the collection specified by the passed key.
func value(withName: String, inPropertyWithKey: String) -> Any?
Retrieves a named object from the collection specified by the passed key.
func value(withUniqueID: Any, inPropertyWithKey: String) -> Any?
Retrieves an object by ID from the collection specified by the passed key.

Coercion

func coerceValue(Any?, forKey: String) -> Any?
Uses type info from the class description and NSScriptCoercionHandler to attempt to convert value for key to the proper type, if necessary.

Constants 定数

NSScriptKeyValueCoding Exception Names
Exceptions raised by key-value coding methods.

See Also 参照

NSObject Script Support NSObjectスクリプトサポート

NSComparisonMethods
A collection of default comparison methods useful for performing specifier tests. 指定子テストを実行するのに有用な省略時の比較メソッドのいちコレクション。
NSScriptingComparisonMethods
A collection of methods useful for comparing script objects. スクリプトオブジェクトを比較するために有用なメソッドのいちコレクション。
NSScriptObjectSpecifiers
A collection of methods providing additional object specifier functionality. 追加のオブジェクト指定子機能を提供するいちコレクション。
class NSScriptCoercionHandler
A mechanism for converting one kind of scripting data to another. ある種のスクリプティングデータを別のものに変換するための仕組み。
class NSScriptExecutionContext
The context in which the current script command is executed. そこにおいて現在のスクリプトコマンドが執行されるところの前後関係。

Related Documentation 関連文書

Cocoa Scripting Guide
Key-Value Coding Programming Guide