251 lines
7.4 KiB
C
251 lines
7.4 KiB
C
/*
|
|
File: AppleEvents.h
|
|
|
|
Contains: AppleEvent Package Interfaces.
|
|
|
|
Version: QuickTime 7.3
|
|
|
|
Copyright: (c) 2007 (c) 1989-2001 by Apple Computer, Inc., all rights reserved
|
|
|
|
Bugs?: For bug reports, consult the following page on
|
|
the World Wide Web:
|
|
|
|
http://developer.apple.com/bugreporter/
|
|
|
|
*/
|
|
#ifndef __APPLEEVENTS__
|
|
#define __APPLEEVENTS__
|
|
|
|
#ifndef __MACTYPES__
|
|
#include <MacTypes.h>
|
|
#endif
|
|
|
|
#ifndef __MIXEDMODE__
|
|
#include <MixedMode.h>
|
|
#endif
|
|
|
|
/*
|
|
Note: The functions and types for the building and parsing AppleEvent
|
|
messages has moved to AEDataModel.h
|
|
*/
|
|
#ifndef __AEDATAMODEL__
|
|
#include <AEDataModel.h>
|
|
#endif
|
|
|
|
|
|
/*Note: The functions for interacting with events has moved to AEInteraction.h*/
|
|
|
|
|
|
#if PRAGMA_ONCE
|
|
#pragma once
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#if PRAGMA_IMPORT
|
|
#pragma import on
|
|
#endif
|
|
|
|
enum {
|
|
/* Keywords for Apple event parameters */
|
|
keyDirectObject = FOUR_CHAR_CODE('----'),
|
|
keyErrorNumber = FOUR_CHAR_CODE('errn'),
|
|
keyErrorString = FOUR_CHAR_CODE('errs'),
|
|
keyProcessSerialNumber = FOUR_CHAR_CODE('psn '), /* Keywords for special handlers */
|
|
keyPreDispatch = FOUR_CHAR_CODE('phac'), /* preHandler accessor call */
|
|
keySelectProc = FOUR_CHAR_CODE('selh'), /* more selector call */
|
|
/* Keyword for recording */
|
|
keyAERecorderCount = FOUR_CHAR_CODE('recr'), /* available only in vers 1.0.1 and greater */
|
|
/* Keyword for version information */
|
|
keyAEVersion = FOUR_CHAR_CODE('vers') /* available only in vers 1.0.1 and greater */
|
|
};
|
|
|
|
/* Event Class */
|
|
enum {
|
|
kCoreEventClass = FOUR_CHAR_CODE('aevt')
|
|
};
|
|
|
|
/* Event ID's */
|
|
enum {
|
|
kAEOpenApplication = FOUR_CHAR_CODE('oapp'),
|
|
kAEOpenDocuments = FOUR_CHAR_CODE('odoc'),
|
|
kAEPrintDocuments = FOUR_CHAR_CODE('pdoc'),
|
|
kAEQuitApplication = FOUR_CHAR_CODE('quit'),
|
|
kAEAnswer = FOUR_CHAR_CODE('ansr'),
|
|
kAEApplicationDied = FOUR_CHAR_CODE('obit'),
|
|
kAEShowPreferences = FOUR_CHAR_CODE('pref') /* sent by Mac OS X when the user chooses the Preferences item */
|
|
};
|
|
|
|
/* Constants for recording */
|
|
enum {
|
|
kAEStartRecording = FOUR_CHAR_CODE('reca'), /* available only in vers 1.0.1 and greater */
|
|
kAEStopRecording = FOUR_CHAR_CODE('recc'), /* available only in vers 1.0.1 and greater */
|
|
kAENotifyStartRecording = FOUR_CHAR_CODE('rec1'), /* available only in vers 1.0.1 and greater */
|
|
kAENotifyStopRecording = FOUR_CHAR_CODE('rec0'), /* available only in vers 1.0.1 and greater */
|
|
kAENotifyRecording = FOUR_CHAR_CODE('recr') /* available only in vers 1.0.1 and greater */
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
* AEEventSource is defined as an SInt8 for compatability with pascal.
|
|
* Important note: keyEventSourceAttr is returned by AttributePtr as a typeShortInteger.
|
|
* Be sure to pass at least two bytes of storage to AEGetAttributePtr - the result can be
|
|
* compared directly against the following enums.
|
|
*/
|
|
typedef SInt8 AEEventSource;
|
|
enum {
|
|
kAEUnknownSource = 0,
|
|
kAEDirectCall = 1,
|
|
kAESameProcess = 2,
|
|
kAELocalProcess = 3,
|
|
kAERemoteProcess = 4
|
|
};
|
|
|
|
/**************************************************************************
|
|
These calls are used to set up and modify the event dispatch table.
|
|
**************************************************************************/
|
|
/*
|
|
* AEInstallEventHandler()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in InterfaceLib 7.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSErr )
|
|
AEInstallEventHandler(
|
|
AEEventClass theAEEventClass,
|
|
AEEventID theAEEventID,
|
|
AEEventHandlerUPP handler,
|
|
long handlerRefcon,
|
|
Boolean isSysHandler) THREEWORDINLINE(0x303C, 0x091F, 0xA816);
|
|
|
|
|
|
/*
|
|
* AERemoveEventHandler()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in InterfaceLib 7.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSErr )
|
|
AERemoveEventHandler(
|
|
AEEventClass theAEEventClass,
|
|
AEEventID theAEEventID,
|
|
AEEventHandlerUPP handler,
|
|
Boolean isSysHandler) THREEWORDINLINE(0x303C, 0x0720, 0xA816);
|
|
|
|
|
|
/*
|
|
* AEGetEventHandler()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in InterfaceLib 7.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSErr )
|
|
AEGetEventHandler(
|
|
AEEventClass theAEEventClass,
|
|
AEEventID theAEEventID,
|
|
AEEventHandlerUPP * handler,
|
|
long * handlerRefcon,
|
|
Boolean isSysHandler) THREEWORDINLINE(0x303C, 0x0921, 0xA816);
|
|
|
|
|
|
|
|
|
|
/**************************************************************************
|
|
These calls are used to set up and modify special hooks into the
|
|
AppleEvent manager.
|
|
**************************************************************************/
|
|
/*
|
|
* AEInstallSpecialHandler()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in InterfaceLib 7.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSErr )
|
|
AEInstallSpecialHandler(
|
|
AEKeyword functionClass,
|
|
AEEventHandlerUPP handler,
|
|
Boolean isSysHandler) THREEWORDINLINE(0x303C, 0x0500, 0xA816);
|
|
|
|
|
|
/*
|
|
* AERemoveSpecialHandler()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in InterfaceLib 7.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSErr )
|
|
AERemoveSpecialHandler(
|
|
AEKeyword functionClass,
|
|
AEEventHandlerUPP handler,
|
|
Boolean isSysHandler) THREEWORDINLINE(0x303C, 0x0501, 0xA816);
|
|
|
|
|
|
/*
|
|
* AEGetSpecialHandler()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in InterfaceLib 7.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSErr )
|
|
AEGetSpecialHandler(
|
|
AEKeyword functionClass,
|
|
AEEventHandlerUPP * handler,
|
|
Boolean isSysHandler) THREEWORDINLINE(0x303C, 0x052D, 0xA816);
|
|
|
|
|
|
|
|
/**************************************************************************
|
|
This call was added in version 1.0.1. If called with the keyword
|
|
keyAERecorderCount ('recr'), the number of recorders that are
|
|
currently active is returned in 'result'
|
|
(available only in vers 1.0.1 and greater).
|
|
**************************************************************************/
|
|
/*
|
|
* AEManagerInfo()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in InterfaceLib 7.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSErr )
|
|
AEManagerInfo(
|
|
AEKeyword keyWord,
|
|
long * result) THREEWORDINLINE(0x303C, 0x0441, 0xA816);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#ifdef PRAGMA_IMPORT_OFF
|
|
#pragma import off
|
|
#elif PRAGMA_IMPORT
|
|
#pragma import reset
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __APPLEEVENTS__ */
|
|
|