Product availability: PDFL |
Platform availability: Macintosh, Windows, UNIX |
Syntax
#define ASCallbackCreate (proc)
File: CorCalls.h |
Line: 353 |
Product availability: PDFL |
Platform availability: Macintosh, Windows, UNIX |
Syntax
#define ASCallbackCreateProto (proc)
File: CorCalls.h |
Line: 352 |
Product availability: PDFL |
Platform availability: Macintosh, Windows, UNIX |
Syntax
#define ASCallbackDestroy
File: CorCalls.h |
Line: 354 |
Product availability: PDFL |
Platform availability: Macintosh, Windows, UNIX |
Syntax
typedef void* ASCallback;
File: CoreExpT.h |
Line: 194 |
Product availability: PDFL |
Platform availability: Macintosh, Windows, UNIX |
Syntax
Deprecated as of Acrobat 8.0.
Creates a callback that allows the Acrobat viewer to call a function in a plug-in. All plug-in functions that are called by the Acrobat viewer must be converted to callbacks before being passed to the viewer.
Whenever possible, plug-ins should not call ASCallbackCreate() directly, but should use the macros ASCallbackCreateProto(), ASCallbackCreateNotification(), and ASCallbackCreateReplacement(). These macros (which eventually call ASCallbackCreate()) have two advantages:
-
They allow compilers to perform type checking, eliminating one extremely common source of plug-in bugs.
-
They handle extensionID
automatically.
Plug-ins must use ASCallbackCreate() directly, for example, when calling a Mac toolbox routine that expects a ProcPtr
.
Parameters
| extensionID — | IN/OUT The gExtensionID extension that calls proc . |
|
| proc — | IN/OUT The user-supplied procedure for which a callback is created. |
Returns
| The newly-created callback. |
See Also
Since
Note
If you call
ASCallbackCreate() directly, you are actually invoking the
ASCallbackCreate() macro, not this HFT routine. The
ASCallbackCreate() macro takes only one parameter, the
proc
, and passes that information into this underlying HFT routine as the second argument. The first argument is always set to
gExtensionID
, which should be the extension identifier of your plug-in.
File: CorProcs.h |
Line: 194 |
Product availability: PDFL |
Platform availability: Macintosh, Windows, UNIX |
Syntax
Deprecated as of Acrobat 8.0.
Destroys a callback.
Parameters
| callback — | IN/OUT The callback to destroy. |
See Also
Since
File: CorProcs.h |
Line: 204 |