NSScriptObjectSpecifiers Protocol Reference
(informal protocol)
| Framework | /System/Library/Frameworks/Foundation.framework |
| Companion guide | |
| Declared in | NSScriptObjectSpecifiers.h |
Overview
Informal protocol. Allows scriptable objects that can provide a fully specified object specifier to themselves within an application to do so. It also enables containers of objects to perform their own specifier evaluation.
For a comprehensive treatment of object specifiers, including sample code, see Object Specifiers in Cocoa Scripting Guide.
Tasks
Working with Object Specifiers
Instance Methods
indicesOfObjectsByEvaluatingObjectSpecifier:
Returns the indices of the specified container objects.
- (NSArray *)indicesOfObjectsByEvaluatingObjectSpecifier:(NSScriptObjectSpecifier *)specifier
Parameters
- specifier
An object specifier for the container objects for which to obtain the indices.
Return Value
A zero-based array of NSNumber objects that identify the zero-based indices of the container objects that match specifier, or nil if no matching objects were found.
Discussion
Containers that want to evaluate some specifiers on their own should implement this method. If this method returns nil, the object specifier will go on to do its own evaluation, so you should only return nil if that's the behavior you want, or if an error occurs. If this method returns an array, the object specifier will use the NSNumber objects in it as the indices. So, if you evaluate the specifier and there are no objects that match, you should return an empty array, not nil. If you find only one object, you should still return its index in an array. Returning an array with a single index where the index is –1 is interpreted to mean all the objects.
For an example implementation, see "Implementing Object Specifiers" in Object Specifiers in Cocoa Scripting Guide
Availability
- Available in Mac OS X v10.0 and later.
Declared In
NSScriptObjectSpecifiers.hobjectSpecifier
Returns an object specifier for the receiver.
- (NSScriptObjectSpecifier *)objectSpecifier
Return Value
A fully specified object specifier to the receiver within the application.
Availability
- Available in Mac OS X v10.0 and later.
Related Sample Code
Declared In
NSScriptObjectSpecifiers.h
© 2006 Apple Computer, Inc. All Rights Reserved. (Last updated: 2006-05-23)