176 lines
4.9 KiB
C
176 lines
4.9 KiB
C
/*
|
|
File: OSAGeneric.h
|
|
|
|
Contains: AppleScript Generic Component Interfaces.
|
|
|
|
Version: QuickTime 7.3
|
|
|
|
Copyright: (c) 2007 (c) 1992-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 __OSAGENERIC__
|
|
#define __OSAGENERIC__
|
|
|
|
#ifndef __MACERRORS__
|
|
#include <MacErrors.h>
|
|
#endif
|
|
|
|
#ifndef __OSA__
|
|
#include <OSA.h>
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#if PRAGMA_ONCE
|
|
#pragma once
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#if PRAGMA_IMPORT
|
|
#pragma import on
|
|
#endif
|
|
|
|
/* NOTE: This interface defines a "generic scripting component."
|
|
The Generic Scripting Component allows automatic dispatch to a
|
|
specific scripting component that conforms to the OSA interface.
|
|
This component supports OSA, by calling AppleScript or some other
|
|
scripting component. Additionally it provides access to the default
|
|
and the user-prefered scripting component.
|
|
*/
|
|
|
|
|
|
enum {
|
|
/* Component version this header file describes */
|
|
kGenericComponentVersion = 0x0100
|
|
};
|
|
|
|
enum {
|
|
kGSSSelectGetDefaultScriptingComponent = 0x1001,
|
|
kGSSSelectSetDefaultScriptingComponent = 0x1002,
|
|
kGSSSelectGetScriptingComponent = 0x1003,
|
|
kGSSSelectGetScriptingComponentFromStored = 0x1004,
|
|
kGSSSelectGenericToRealID = 0x1005,
|
|
kGSSSelectRealToGenericID = 0x1006,
|
|
kGSSSelectOutOfRange = 0x1007
|
|
};
|
|
|
|
typedef OSType ScriptingComponentSelector;
|
|
typedef OSAID GenericID;
|
|
/* get and set the default scripting component */
|
|
/*
|
|
* OSAGetDefaultScriptingComponent()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in AppleScriptLib 1.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSAError )
|
|
OSAGetDefaultScriptingComponent(
|
|
ComponentInstance genericScriptingComponent,
|
|
ScriptingComponentSelector * scriptingSubType) FIVEWORDINLINE(0x2F3C, 0x0004, 0x1001, 0x7000, 0xA82A);
|
|
|
|
|
|
/*
|
|
* OSASetDefaultScriptingComponent()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in AppleScriptLib 1.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSAError )
|
|
OSASetDefaultScriptingComponent(
|
|
ComponentInstance genericScriptingComponent,
|
|
ScriptingComponentSelector scriptingSubType) FIVEWORDINLINE(0x2F3C, 0x0004, 0x1002, 0x7000, 0xA82A);
|
|
|
|
|
|
/* get a scripting component instance from its subtype code */
|
|
/*
|
|
* OSAGetScriptingComponent()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in AppleScriptLib 1.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSAError )
|
|
OSAGetScriptingComponent(
|
|
ComponentInstance genericScriptingComponent,
|
|
ScriptingComponentSelector scriptingSubType,
|
|
ComponentInstance * scriptingInstance) FIVEWORDINLINE(0x2F3C, 0x0008, 0x1003, 0x7000, 0xA82A);
|
|
|
|
|
|
/* get a scripting component selector (subType) from a stored script */
|
|
/*
|
|
* OSAGetScriptingComponentFromStored()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in AppleScriptLib 1.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSAError )
|
|
OSAGetScriptingComponentFromStored(
|
|
ComponentInstance genericScriptingComponent,
|
|
const AEDesc * scriptData,
|
|
ScriptingComponentSelector * scriptingSubType) FIVEWORDINLINE(0x2F3C, 0x0008, 0x1004, 0x7000, 0xA82A);
|
|
|
|
|
|
/* get a real component instance and script id from a generic id */
|
|
/*
|
|
* OSAGenericToRealID()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in AppleScriptLib 1.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSAError )
|
|
OSAGenericToRealID(
|
|
ComponentInstance genericScriptingComponent,
|
|
OSAID * theScriptID,
|
|
ComponentInstance * theExactComponent) FIVEWORDINLINE(0x2F3C, 0x0008, 0x1005, 0x7000, 0xA82A);
|
|
|
|
|
|
/* get a generic id from a real component instance and script id */
|
|
/*
|
|
* OSARealToGenericID()
|
|
*
|
|
* Availability:
|
|
* Non-Carbon CFM: in AppleScriptLib 1.1 and later
|
|
* CarbonLib: in CarbonLib 1.0 and later
|
|
* Mac OS X: in version 10.0 and later
|
|
*/
|
|
EXTERN_API( OSAError )
|
|
OSARealToGenericID(
|
|
ComponentInstance genericScriptingComponent,
|
|
OSAID * theScriptID,
|
|
ComponentInstance theExactComponent) FIVEWORDINLINE(0x2F3C, 0x0008, 0x1006, 0x7000, 0xA82A);
|
|
|
|
|
|
|
|
|
|
|
|
#ifdef PRAGMA_IMPORT_OFF
|
|
#pragma import off
|
|
#elif PRAGMA_IMPORT
|
|
#pragma import reset
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* __OSAGENERIC__ */
|
|
|