org.rococoa.cocoa.foundation.categories
Interface NSScriptKeyValueCoding

All Superinterfaces:

ObjCObject

public interface NSScriptKeyValueCoding
extends ObjCObject

This file was autogenerated by JNAerator,
a tool written by Olivier Chafik that uses a few opensource projects..
For help, please visit NativeLibs4Java, Rococoa, or JNA.

Nested Class Summary

static interface

NSScriptKeyValueCoding._static_

Method Summary

NSObject	coerceValue_forKey(ObjCObject value, NSString key) If the keyed property is an attribute or to-one relationship, coerce the object into an object suitable for setting as the value of the property and return that object.
void	insertValue_atIndex_inPropertyWithKey(ObjCObject value, NSUInteger index, NSString key) Insert, remove, or replace the indexed object in the value of the to-many relationship identified by the key.
void	insertValue_inPropertyWithKey(ObjCObject value, NSString key) Insert the object into the value of the to-many relationship identified by the key, at a location that makes sense for a scripted Make command with no "at" parameter (either the beginning or the end, typically).
void	removeValueAtIndex_fromPropertyWithKey(NSUInteger index, NSString key) Original signature : -(void)removeValueAtIndex:(NSUInteger) fromPropertyWithKey:(NSString*) from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:35
void	replaceValueAtIndex_inPropertyWithKey_withValue(NSUInteger index, NSString key, ObjCObject value) Original signature : -(void)replaceValueAtIndex:(NSUInteger) inPropertyWithKey:(NSString*) withValue:(id) from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:36
NSObject	valueAtIndex_inPropertyWithKey(NSUInteger index, NSString key) Return the indexed object in the value of the to-many relationship identified by the key.
NSObject	valueWithName_inPropertyWithKey(NSString name, NSString key) Return the named object in the value of the to-many relationship identified by the key.
NSObject	valueWithUniqueID_inPropertyWithKey(ObjCObject uniqueID, NSString key) Return the uniquely dentified object in the value of the to-many relationship identified by the key. uniqueID must be either an NSNumber or an NSString.

Methods inherited from interface org.rococoa.ObjCObject

id

Method Detail

valueAtIndex_inPropertyWithKey

NSObject valueAtIndex_inPropertyWithKey(NSUInteger index,
                                        NSString key)

Return the indexed object in the value of the to-many relationship identified by the key. The default implementation of this method searches the class of the receiver for a method whose name matches the pattern -valueInAtIndex: and invokes it if one is found. If no such method is found an exception is thrown. (In general. Other things may also be done for backward binary compatibility.) If your application requires Mac OS 10.4 or newer you can ignore this method. Fulfilling the more modern requirements of KVC-compliance established by -[NSObject(NSKeyValueCoding) valueForKey:] is enough to make Cocoa's scripting support work for the keyed relationship.
Original signature : -(id)valueAtIndex:(NSUInteger) inPropertyWithKey:(NSString*)
from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:18

valueWithName_inPropertyWithKey

NSObject valueWithName_inPropertyWithKey(NSString name,
                                         NSString key)

Return the named object in the value of the to-many relationship identified by the key. The default implementation of this method searches the class of the receiver for a method whose name matches the pattern -valueInWithName: and invokes it if one is found. The declared type of the method's parameter must be NSString *. If no such method is found an exception is thrown. Cocoa's scripting support uses this method during the evaluation of NSNameSpecifiers if it's overridden or a -valueInWithName: method is implemented for the key in question. You can take advantage of this to optimize the evaluation of name specifiers. (Doing this is less frequently useful than doing the equivalent thing for unique IDs.) If you don't then Cocoa does a linear search of all of the related objects.
Original signature : -(id)valueWithName:(NSString*) inPropertyWithKey:(NSString*)
from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:24

valueWithUniqueID_inPropertyWithKey

NSObject valueWithUniqueID_inPropertyWithKey(ObjCObject uniqueID,
                                             NSString key)

Return the uniquely dentified object in the value of the to-many relationship identified by the key. uniqueID must be either an NSNumber or an NSString. The default implementation of this method searches the class of the receiver for a method whose name matches the pattern -valueInWithUniqueID: and invokes it if one is found. The declared type of the unique ID parameter must be id, NSNumber *, NSString *, or one of the scalar types that is supported by NSNumber. If no such method is found an exception is thrown. Cocoa's scripting support uses this method during the evaluation of NSUniqueIDSpecifiers if it's overridden or a -valueInWithUniqueID: method is implemented for the key in question. You can take advantage of this to optimize the evaluation of unique ID specifiers. If you don't then Cocoa just does a linear search of all of the related objects.
Original signature : -(id)valueWithUniqueID:(id) inPropertyWithKey:(NSString*)
from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:28

insertValue_atIndex_inPropertyWithKey

void insertValue_atIndex_inPropertyWithKey(ObjCObject value,
                                           NSUInteger index,
                                           NSString key)

Insert, remove, or replace the indexed object in the value of the to-many relationship identified by the key. The default implementations of these methods search the class of the receiver for a method whose name matches the pattern -insertIn:atIndex:, -removeFromAtIndex:, or -replaceIn:atIndex:, respectively, and invokes it if one is found. If no such method is found an exception is thrown. (In general. Other things may also be done for backward binary compatibility.) If your application requires Mac OS 10.4 or newer you can ignore these methods. Fulfilling the more modern requirements of KVC-compliance established by -[NSObject(NSKeyValueCoding) mutableArrayValueForKey:] is enough to make Cocoa's scripting support work for the keyed relationship.
Original signature : -(void)insertValue:(id) atIndex:(NSUInteger) inPropertyWithKey:(NSString*)
from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:34

removeValueAtIndex_fromPropertyWithKey

void removeValueAtIndex_fromPropertyWithKey(NSUInteger index,
                                            NSString key)

Original signature : -(void)removeValueAtIndex:(NSUInteger) fromPropertyWithKey:(NSString*)
from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:35

replaceValueAtIndex_inPropertyWithKey_withValue

void replaceValueAtIndex_inPropertyWithKey_withValue(NSUInteger index,
                                                     NSString key,
                                                     ObjCObject value)

Original signature : -(void)replaceValueAtIndex:(NSUInteger) inPropertyWithKey:(NSString*) withValue:(id)
from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:36

insertValue_inPropertyWithKey

void insertValue_inPropertyWithKey(ObjCObject value,
                                   NSString key)

Insert the object into the value of the to-many relationship identified by the key, at a location that makes sense for a scripted Make command with no "at" parameter (either the beginning or the end, typically). The default implementation of this method searches the class of the receiver for a method whose name matches the pattern -insertIn: and invokes it if one is found. In an application with .scriptSuite/.scriptTerminology-declared scriptability, NSCreateCommand may invoke this method if the to-many relationship's .scriptSuite declaration has a LocationRequiredToCreate = NO entry, and its default implementation throws an exception if no -insertIn: method is found. In an application with .sdef-declared scriptability, NSCreateCommand may invoke this method for any to-many relationship, and (starting in Mac OS 10.5) its default implementation never throws an exception. It inserts the new object at either the beginning or the end of the relationship, depending on the value of the "insert-at-beginning" attribute of the subelement of the declaring element.
Original signature : -(void)insertValue:(id) inPropertyWithKey:(NSString*)
from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:42

coerceValue_forKey

NSObject coerceValue_forKey(ObjCObject value,
                            NSString key)

If the keyed property is an attribute or to-one relationship, coerce the object into an object suitable for setting as the value of the property and return that object. If the keyed property is a to-many relationship, coerce the object into an object suitable for inserting in the value of the property and return that object. The default implementation of this method searches the class of the receiver for a method whose name matches the pattern -coerceValueFor: and invokes it if one is found. If no such method is found and the application's scriptability is not .sdef-declared then it sends a -coerceValue:toClass: message to [NSScriptCoercionHandler sharedCoercionHandler].
Original signature : -(id)coerceValue:(id) forKey:(NSString*)
from NSScriptKeyValueCoding native declaration : NSScriptKeyValueCoding.h:48