NSAppleEventDescriptor — Mac OS X 10.0


This class is primarily used to retrieve information about an Apple Event in a Cocoa application. A handful of methods in the scripting classes of the Foundation framework either take an event descriptor object or return one. For example, in the class NSAppleScript we expect an NSAppleEventDescriptor object to be returned by the script execution methods. This class is only useful for creating event descriptor objects to return to other objects, or to extract information about an Apple Event descriptor. Currently, Cocoa has no mechanism for sending raw Apple Events; for that you must rely on the Carbon Apple Event APIs.

@interface NSAppleEventDescriptor : NSObject <NSCopying>
                                  // Initializers
   - (id)initListDescriptor;
   - (id)initRecordDescriptor;
   - (id)initWithAEDescNoCopy:(const AEDesc *)aeDesc;
   - (id)initWithDescriptorType:(DescType)descriptorType  
                                 bytes:(const void *)bytes 
                                 length:(unsigned int)byteCount;
   - (id)initWithDescriptorType:(DescType)descriptorType  
                                 data:(NSData *)data;
   - (id)initWithEventClass:(AEEventClass)eventClass 
                                 targetDescriptor:(NSAppleEventDescriptor *)targetDescriptor 
                                  // Accessor Methods
   - (void)setDescriptor:(NSAppleEventDescriptor *)descriptor 
   - (void)setAttributeDescriptor ...

Get Cocoa in a Nutshell now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.