Instance Method インスタンスメソッド

copyScriptingValue(_:forKey:withProperties:)

Creates and returns one or more scripting objects to be inserted into the specified relationship by copying the passed-in value and setting the properties in the copied object or objects. 指定されたリレーションシップへと挿入されるひとつ以上のスクリプティングオブジェクトを作成して返します、それは渡された値をコピーしてコビーされたオブジェクトまたは複数オブジェクトにおいてプロパティを設定することによってです。

Declaration 宣言

func copyScriptingValue(_ value: Any, 
                 forKey key: String, 
         withProperties properties: [String : Any]) -> Any?

Parameters パラメータ

value: An object or objects to be copied. コピーされるオブジェクトまたは複数のオブジェクト。 The type must match the type of the property identified by key. (See also the Discussion section.) （またDiscussion節を見てください。）

For example, if the property is a to-many relationship, value will always be an array of objects to be copied, and this method must therefore return an array of objects.
key: A key that identifies the relationship into which to insert the copied object or objects. コピーされたオブジェクトまたは複数のオブジェクトがそこへと挿入されるところのリレーションシップを識別するキー。
properties: The properties to be set in the copied object or objects. コピーされたオブジェクトまたは複数のオブジェクトに設定されることになるプロパティ。 Derived from the "with properties" parameter of a duplicate command. (See also the Discussion section.) （またDiscussion節を見てください。）

Return Value 戻り値

The copied object or objects. コピーされたオブジェクトまたは複数のオブジェクト。 Returns nil if an error occurs.

Discussion 解説

You can override the copyScriptingValue method to take more control when your application is sent a duplicate command. This method is invoked on the prospective container of the copied object or objects. このメソッドは、コピーされたオブジェクトまたは複数のオブジェクトの予想されるコンテナ上で発動されます。 The properties are derived from the with properties parameter of the duplicate command. The returned objects or objects are then inserted into the container using key-value coding. 返されるオブジェクトまたは複数のオブジェクトは、それから「キー値」コーディングを使ってコンテナへと挿入されます。

When this method is invoked by Cocoa, neither the value nor the properties will have yet been coerced using the NSScriptKeyValueCoding method coerceValue(_:forKey:). For sdef-declared scriptability, however, the types of the passed-in objects reliably match the relevant sdef declarations. sdefで宣言されるスクリプト対応機能情報にとっては、しかしながら、渡されたオブジェクトの型は期待通りに関係するsdef宣言部分と一致します。

The default implementation of this method copies scripting objects by sending copyWithZone: to the object or objects specified by value. You override this method for situations where this is not sufficient, such as in Core Data applications, in which new objects must be initialized with [NSManagedObject initWithEntity:insertIntoManagedObjectContext:].

See Also 参照

Scripting スクリプトを書く

var classCode: FourCharCode

The receiver's Apple event type code, as stored in the NSScriptClassDescription object for the object’s class.

var className: String

A string containing the name of the class. クラスの名前を格納している文字列。

func newScriptingObject(of: AnyClass, forValueForKey: String, withContentsValue: Any?, properties: [String : Any]) -> Any?

Creates and returns an instance of a scriptable class, setting its contents and properties, for insertion into the relationship identified by the key. スクリプト対応クラスのインスタンスを作成して返します、それの内容とプロパティを設定します、キーによって識別されるリレーションシップへの挿入のためです。

var scriptingProperties: [String : Any]?

An NSString-keyed dictionary of the receiver's scriptable properties.

func scriptingValue(for: NSScriptObjectSpecifier) -> Any?

Given an object specifier, returns the specified object or objects in the receiving container. あるオブジェクト指定子を与えられて、受け取っているコンテナの中の指定されたオブジェクトまたは複数のオブジェクトを返します。