Cocoa Scripting Guide
PDF
Introduction
Overview of Cocoa Support for Scriptable Applications
AppleScript and Scriptable Applications
The AppleScript Object Model
Scriptability Information
Reliance on Key-Value Coding
Interaction With Cocoa Bindings and Core Data
Scriptability and Undo
Snapshot of Cocoa Scripting
A Real World Scripting Example
Current Limitations of Cocoa Scripting Support
Designing for Scriptability
Designing a New Scriptable Application
Adding Scriptability to an Existing Application
Implementing a Scriptable Application
Implementation Guidelines
Supply a Scripting Definition File
Concentrate Scriptable Behavior in Model Objects
Provide Keys for Key-Value Coding
Add the Scripting Definition File to Your Xcode Project
Turn On Scripting Support in Your Application
Implement Object Specifier Methods for Scriptable Classes
Use the Document Architecture
Access the Text Suite
Preparing a Scripting Definition File
Structure of a Scripting Definition File
Create a Scripting Definition File
Add Information to the Scripting Definition File
Getting and Setting Properties and Elements
Overview of Getting and Setting Values
Key-Value Coding and Cocoa Scripting
Sample KVC-Compliant Accessor Methods
Special Accessor Methods
Support for the Properties Property
Coercion
Object Specifiers
Overview of Object Specifiers
Cocoa Object Specifier Classes
Implementing the Object Specifier Method
Implementing A Method for Evaluating Object Specifiers
Implicitly Specified Subcontainers
Script Commands
Script Commands Overview
Implementing an Object-First Command—Rotate
Implementing a Verb-First Command—Align
Modifying a Standard Command
Summary of AppleScript Command Support
Testing, Debugging, and Performance
Scriptability Test Plan
Use AppleScript Scripts to Test Your Application
Turn On Debugging Output for Scripting
Debugging Scriptability Information
Additional Debugging Tips
Performance Issues for Scriptability
Cocoa Scripting Classes and Categories
Script Commands and Scriptability Information
Object Specifiers, Logical Tests, and Related Categories
Key-Value Coding and Value Coercion
Subclasses for Standard AppleScript Commands
Manipulation of Apple Events
How Cocoa Applications Handle Apple Events
Apple Event Handling Overview
Apple Events Sent by the Mac OS
Installing an Apple Event Handler
Suspending and Resuming Apple Events and Script Commands
Appendix A: Evolution of Cocoa Scriptability Information
Scriptability Terms
Changes in Scriptability Information Versions
Converting and Updating Scriptability Information
Editing Scriptability Information
Appendix B: Script Suite and Script Terminology Files
Script Suite Files
Script Terminology Files
Cocoa Scripting’s Built-in Script Suites
Creating Your Own Script Suite Files
Revision History
Glossary
Related Reference
Objective-C
NSAppleEventDescriptor
NSAppleEventManager
NSAppleScript
NSClassDescription
NSCloneCommand
NSCloseCommand
NSComparisonMethods
NSCountCommand
NSCreateCommand
NSDeleteCommand
NSExistsCommand
NSGetCommand
NSIndexSpecifier
NSLogicalTest
NSMiddleSpecifier
NSMoveCommand
NSNameSpecifier
NSPositionalSpecifier
NSPropertySpecifier
NSQuitCommand
NSRandomSpecifier
NSRangeSpecifier
NSRelativeSpecifier
NSScriptClassDescription
NSScriptCoercionHandler
NSScriptCommand
NSScriptCommandDescription
NSScriptExecutionContext
NSScriptKeyValueCoding
NSScriptObjectSpecifier
NSScriptObjectSpecifiers
NSScriptSuiteRegistry
NSScriptWhoseTest
NSScriptingComparisonMethods
NSSetCommand
NSSpecifierTest
NSUniqueIDSpecifier
NSWhoseSpecifier
Related Documents
Key-Value Coding Programming Guide
Cocoa Fundamentals Guide