Progress Monitors; Transition Handlers - Adobe ACROBAT SDK 8.1 Manual

Adobe Acrobat SDK
Developing Plug-ins and Applications
Dispose of a path (not the underlying file) by using the
●
method.
Flush data on a volume by using the
●
Handle asynchronous I/O operations by using the following callback methods:
●
ASFileSysAsyncReadProc
Handle multiple read requests by using the
●
For details on each of the callbacks in a file system, see the description of
and PDF Library API Reference.

Progress monitors

Progress monitors provide feedback to a user on the progress of a time-consuming operation. Some
potentially time-consuming methods in the Acrobat core API require a progress monitor as a parameter.
Acrobat has a default progress monitor, which generally is sufficient for plug-ins to use. The built-in
progress monitor can be obtained by using the
Plug-ins can use the default progress monitor or implement their own by providing a set of callbacks,
specifying them in the
the methods that require a progress monitor (there is no explicit registration method).
Using a progress monitor, you can perform the following tasks:
Initialize the progress monitor and display it with a current value of zero by invoking the
●
PMBeginOperationProc
Draw a full progress monitor, then remove the progress monitor from the display by invoking the
●
PMEndOperationProc
Set the value that corresponds to a full progress monitor display by invoking the
●
PMSetDurationProc
Set the current value of the progress monitor and update the display by invoking the
●
PMSetCurrValueProc
Get the progress monitor's maximum value by invoking the
●
Get the progress monitor's current value by invoking the
●
For details, see the description of

Transition handlers

Transitions allow effects such as dissolves or wipe-downs when displaying a new page. New transition
types can be added by defining and registering a transition handler.
To add a new transition, you must provide a set of callbacks, specify them in the
structure, and register them by invoking the
Using a transition handler, you can perform the following tasks:
Get the transition type by invoking the
●
Perform the transition (change to the next page with this transition style) by invoking the
●
AVTransHandlerExecuteProc
ASFileSysFlushVolumeProc
or
ASFileSysAsyncWriteProc
ASProgressMonitorRec
method.
method.
method.
method.
ASProgressMonitorRec
AVAppRegisterTransHandler
AVTransHandlerGetTypeProc
method.
ASFileSysDisposePathNameProc
.
ASFileSysMReadRequestProc
AVAppGetDocProgressMonitor
data structure, and passing a pointer to the structure to
PMGetDurationProc
PMGetCurrValueProc
in the Acrobat and PDF Library API Reference.
Creating Handlers
Progress monitors
callback method.
callback method.
in the Acrobat
ASFileSysRec
method.
method.
method.
AVTransHandler
method.
method.
149
callback
data