DL Logo

General Definitions

ASBoolToBool

Header: CoreExpT.h:57

Syntax

#define ASBoolToBool ( boolval )( boolval != FALSE )

ASCryptStmModeError

Header: ASExpT.h:318

Syntax

#define ASCryptStmModeError 0x0008

ASFourCharCode

Header: ASExpT.h:1618

Syntax

#define ASFourCharCode ( x )( x )

ASFourCharCode

Header: ASExpT.h:1620

Syntax

#define ASFourCharCode ( x )( 0U )

ASMAXInt16

Header: ASNumTypes.h:66

Syntax

#define ASMAXInt16 (( ASInt16 ) 0x7FFF )

ASMAXInt32

Header: ASNumTypes.h:70

Syntax

#define ASMAXInt32 (( ASInt32 ) 0x7FFFFFFF )

ASMAXInt64

Header: ASNumTypes.h:74

Syntax

#define ASMAXInt64 (( ASInt64 ) 0x7FFFFFFFFFFFFFFFL L )

ASMAXInt8

Header: ASNumTypes.h:62

Syntax

#define ASMAXInt8 (( ASInt8 ) 0x7F )

ASMAXUns16

Header: ASNumTypes.h:108

Syntax

#define ASMAXUns16 (( ASUns16 ) 0xFFFF )

ASMAXUns32

Header: ASNumTypes.h:112

Syntax

#define ASMAXUns32 (( ASUns32 ) 0xFFFFFFFF )

ASMAXUns64

Header: ASNumTypes.h:116

Syntax

#define ASMAXUns64 (( ASUns64 ) 0xFFFFFFFFFFFFFFFFL L )

ASMAXUns8

Header: ASNumTypes.h:104

Syntax

#define ASMAXUns8 (( ASUns8 ) 0xFF )

ASMINInt16

Header: ASNumTypes.h:68

Syntax

#define ASMINInt16 (( ASInt16 ) 0x8000 )

ASMINInt32

Header: ASNumTypes.h:72

Syntax

#define ASMINInt32 (( ASInt32 ) 0x80000000 )

ASMINInt64

Header: ASNumTypes.h:76

Syntax

#define ASMINInt64 (( ASInt64 ) 0x8000000000000000L L )

ASMINInt8

Header: ASNumTypes.h:64

Syntax

#define ASMINInt8 (( ASInt8 ) 0x80 )

ASMINUns16

Header: ASNumTypes.h:110

Syntax

#define ASMINUns16 (( ASUns16 ) 0x0000 )

ASMINUns32

Header: ASNumTypes.h:114

Syntax

#define ASMINUns32 (( ASUns32 ) 0x00000000 )

ASMINUns64

Header: ASNumTypes.h:118

Syntax

#define ASMINUns64 (( ASUns64 ) 0x0000000000000000L L )

ASMINUns8

Header: ASNumTypes.h:106

Syntax

#define ASMINUns8 (( ASUns8 ) 0x00 )

ASUSE_OBSOLETE_TYPES

Header: CoreExpT.h:213

Syntax

#define ASUSE_OBSOLETE_TYPES 1

AS_ARCH_64BIT

Header: ASNumTypes.h:35

Syntax

#define AS_ARCH_64BIT 1

AS_ARCH_64BIT

Header: ASNumTypes.h:37

Syntax

#define AS_ARCH_64BIT 0

AS_UNUSED_PARAM

Header: ASExpT.h:28

Syntax

#define AS_UNUSED_PARAM ( type, name ) type name __attribute__(( unused ) )

AS_UNUSED_PARAM

Header: ASExpT.h:30

Syntax

#define AS_UNUSED_PARAM ( type, name ) type name

AS_UNUSED_VAR

Header: ASExpT.h:34

Syntax

#define AS_UNUSED_VAR ( type, name ) type __attribute__(( unused ) ) name

AS_UNUSED_VAR

Header: ASExpT.h:36

Syntax

#define AS_UNUSED_VAR ( type, name )

CHECKTYPE

Header: ASExpT.h:3739

Syntax

#define CHECKTYPE ( type, data )(( void *)(( data ) ==(( type ) data ) ? data : data ) )

CHECKTYPE

Header: ASExpT.h:3741

Syntax

#define CHECKTYPE ( type, data )(( void *) data )

CHECK_CHARSTR

Header: ASExpT.h:3747

Syntax

#define CHECK_CHARSTR ( data )(( void *) data )

CHECK_CHARSTR

Header: ASExpT.h:3749

Syntax

#define CHECK_CHARSTR ( data ) CHECKTYPE( char *, data )

CancelProc

Header: ASExpT.h:3703

Syntax

#define CancelProc ASCancelProc

Used By

FALSE

Header: ASNumTypes.h:143

Syntax

#define FALSE 0

HAS_32BIT_ATOMS

Header: CoreExpT.h:136

Syntax

#define HAS_32BIT_ATOMS 1

HAS_32BIT_ATOMS

Header: CoreExpT.h:138

Syntax

#define HAS_32BIT_ATOMS 0

HAS_BOOL_SUPPORT

Header: ASNumTypes.h:124

Syntax

#define HAS_BOOL_SUPPORT 1

HAS_BOOL_SUPPORT

Header: ASNumTypes.h:126

Syntax

#define HAS_BOOL_SUPPORT 0

HUGEPTRTYPE

Header: CoreExpT.h

Syntax

#define HUGEPTRTYPE

HugePtr

Header: CoreExpT.h:129

Syntax

#define HugePtr char HUGEPTRTYPE *

Int16

Header: CoreExpT.h:217

Syntax

#define Int16 ASInt16

Int16P

Header: CoreExpT.h:218

Syntax

#define Int16P ASInt16P

Int32

Header: CoreExpT.h:219

Syntax

#define Int32 ASInt32

Int32P

Header: CoreExpT.h:220

Syntax

#define Int32P ASInt32P

Int8

Header: CoreExpT.h:215

Syntax

#define Int8 ASInt8

Int8P

Header: CoreExpT.h:216

Syntax

#define Int8P ASInt8P

MAXInt16

Header: CoreExpT.h:231

Syntax

#define MAXInt16 ASMAXInt16

MAXInt32

Header: CoreExpT.h:233

Syntax

#define MAXInt32 ASMAXInt32

MAXInt8

Header: CoreExpT.h:229

Syntax

#define MAXInt8 ASMAXInt8

MAXUns16

Header: CoreExpT.h:238

Syntax

#define MAXUns16 ASMAXUns16

MAXUns32

Header: CoreExpT.h:240

Syntax

#define MAXUns32 ASMAXUns32

MAXUns8

Header: CoreExpT.h:236

Syntax

#define MAXUns8 ASMAXUns8

MINInt16

Header: CoreExpT.h:232

Syntax

#define MINInt16 ASMINInt16

MINInt32

Header: CoreExpT.h:234

Syntax

#define MINInt32 ASMINInt32

MINInt8

Header: CoreExpT.h:230

Syntax

#define MINInt8 ASMINInt8

MINUns16

Header: CoreExpT.h:239

Syntax

#define MINUns16 ASMINUns16

MINUns32

Header: CoreExpT.h:241

Syntax

#define MINUns32 ASMINUns32

MINUns8

Header: CoreExpT.h:237

Syntax

#define MINUns8 ASMINUns8

NULL

Header: CoreExpT.h:107

Syntax

#define NULL 0

NULL

Header: CoreExpT.h:109

Syntax

#define NULL (( void *) 0 )

POINTER_64_BITS

Header: CoreExpT.h:32

Syntax

#define POINTER_64_BITS 1

ProgressMonitor

Header: ASExpT.h:3678

Syntax

#define ProgressMonitor ASProgressMonitor

Used By

ProgressMonitorRec

Header: ASExpT.h:3679

Syntax

#define ProgressMonitorRec ASProgressMonitorRec

ProgressProc

Header: ASExpT.h:3709

Syntax

#define ProgressProc ASProgressProc

TRUE

Header: ASNumTypes.h:139

Syntax

#define TRUE 1

UNDEFINED_CONFIGURATION_SELECTOR

Header: CoreExpT.h:204

Description

This constant is returned by ASGetConfiguration() when the selector passed in is unknown to the application.

Syntax

#define UNDEFINED_CONFIGURATION_SELECTOR (( void *) - 1 )

Uns16

Header: CoreExpT.h:224

Syntax

#define Uns16 ASUns16

Uns16P

Header: CoreExpT.h:225

Syntax

#define Uns16P ASUns16P

Uns32

Header: CoreExpT.h:226

Syntax

#define Uns32 ASUns32

Uns32P

Header: CoreExpT.h:227

Syntax

#define Uns32P ASUns32P

Uns8

Header: CoreExpT.h:222

Syntax

#define Uns8 ASUns8

Returned From

Uns8P

Header: CoreExpT.h:223

Syntax

#define Uns8P ASUns8P

_open64_

Header: ASExpT.h:43

Syntax

#define _open64_ open64

boolean

Header: CoreExpT.h:244

Syntax

#define boolean ASBool

false

Header: ASNumTypes.h:134

Syntax

#define false 0

kASMAXEnum16

Header: CoreExpT.h:80

Syntax

#define kASMAXEnum16 ASMAXInt16

kASMAXEnum16

Header: CoreExpT.h:96

Syntax

#define kASMAXEnum16 ASMAXInt16

kASMAXEnum8

Header: CoreExpT.h:78

Syntax

#define kASMAXEnum8 ASMAXInt16

kASMAXEnum8

Header: CoreExpT.h:94

Syntax

#define kASMAXEnum8 ASMAXInt8

kMoreTextKey

Header: ASExtraExpT.h:366

Syntax

#define kMoreTextKey "MoreText"

open64

Header: ASExpT.h:4102

Syntax

#define open64 _open64_

os_size_t

Header: CoreExpT.h:247

Syntax

#define os_size_t ASSize_t

Used By

true

Header: ASNumTypes.h:131

Syntax

#define true 1

General Enumerations

ASMungeOptions

Header: ASExtraExpT.h:277

Description

A value that determines the actions to be taken when ASCabMunge() is called. keyCab is the ASCab that provides the keys determining how theCab is to be changed. During an ASCabMunge() operation, the key cab will not be altered.

Value options for ASCabMungeAction.

Enum Constants

kASMungeRemove
Any keys in keyCab are removed from theCab.
kASMungeRemoveUnknown
Any keys in theCab which are not also in keyCab are removed.
kASMungeRemoveDefaults
Any keys in keyCab which are also in theCab and have the same value in theCab are removed.
kASMungeRemoveBadValues
Any keys in theCab which are also in keyCab but have different values are removed.
kASMungeCopy
All key/value pairs in keyCab are copied into theCab.
kASMungeReplace
Any keys in theCab which are also in keyCab are replaced with the values in keyCab.
kASMungeCopyMissing
Any keys in keyCab which are not in theCab are copied over to theCab.
kASMungeRemoveNulls
Any keys in keyCab with a value of NULL are removed from theCab.

ASReportOptions

Header: ASExtraExpT.h:353

Description

Used in an ASReportProc to indicate what kind of information is being reported.

Value options for ASReportType.

Related Methods

Enum Constants

kASReportNote
A note.
kASReportWarning
A warning.
kASReportError
An error.

ASTimeOptions

Header: ASExpT.h:4021

Description

A constant indicating a string format for representing a date and time. See PDF date formats, page 87. You can find this document on the web store of the International Standards Organization (ISO).

Value options for ASDateTimeFormat.

Enum Constants

kASTimeNone=0
None.
kASTimePDF
PDF date format. See the description of Dates in "Common Data Structures" in ISO 32000-1:2008, Document Management-Portable Document Format-Part 1: PDF 1.7, section 7.9.4, page 87.
kASTimeUniversal
Slight variations of the time format expressed in ISO 8601. ISO 8601 is the international standard for formatting times and dates, first published in 1988.
kASTimeUniversalH
Slight variations of the time format expressed in ISO 8601.
kASTimeUTC_ASN1
UTC ASN1 format.
kASTimeGENERALIZED_ASN1
ASN1 format.

ASValueOptions

Header: ASExtraExpT.h:109

Description

ASCabinet objects can be used to store arbitrary key/value pairs. The keys are always NULL-terminated strings containing only low ASCII alphanumeric characters. The various types of values are enumerated here.

Enum Constants

kASValueBool
An ASBool.
kASValueInteger
An ASInt32.
kASValueAtom
An ASAtom.
kASValueDouble
A double precision floating-point number.
kASValueString
A NULL-terminated, unencoded string.
kASValueText
An ASText object.
kASValueBinary
A binary blob of any size.
kASValuePointer
A pointer to something outside the cabinet.
kASValueCabinet
Another cabinet.
kASValueNull
The key exists but has no useful value. For example, the key may be a placeholder.
kASValueUns
An ASUns32.
kASValueInt64
An ASInt64.
kASValueUns64
An ASUns64.
kASValueUnknown=-1
An invalid type.

PDFLFlattenProgressMarker

Header: ASExpT.h:3713

Enum Constants

kPDFLFlattenProg_EnterInFlattener=0
kPDFLFlattenProg_FindObjectsInvolvedInTransparency
kPDFLFlattenProg_TextHeuristics
kPDFLFlattenProg_IdentifyingComplexityRegion
kPDFLFlattenProg_ComputingComplexityRegionClippath
kPDFLFlattenProg_EnterInPlanarMap
kPDFLFlattenProg_FlattenAtomicRegions
kPDFLFlattenProg_RasterizingComplexityRegion

PDFLRenderProgressMarker

Header: ASExpT.h:3725

Enum Constants

kPDFLRenderProg_Unknown=0
kPDFLRenderProg_Stage1
kPDFLRenderProg_Stage2
kPDFLRenderProg_Stage3
kPDFLRenderProg_Stage4
kPDFLRenderProg_Stage5
kPDFLRenderProg_Stage6
kPDFLRenderProg_Stage7
kPDFLRenderProg_Stage8
kPDFLRenderProg_Stage9

UTFOptions

Header: ASExpT.h:3853

Description

Describes the various Unicode formats you can place into and read out of an ASText object.

Value options for ASUnicodeFormat.

Enum Constants

kUTF16BigEndian
Always returns the bytes in big-endian order.
kUTF16HostEndian
Returns the bytes in the host's native endian order, whatever is natural for an ASUns16.
kUTF8
Endian neutral.
kUTF32BigEndian
Always returns the bytes in big-endian order.
kUTF32HostEndian
Returns the bytes in the host's native endian order, whatever is natural for an ASUns32.

General Typedefs

ASArraySize

Header: ASExpT.h:124

Description

An array size value for use in callback procedures.

Syntax

typedef ASUns32 ASArraySize;

Returned From

Used By

ASBool

Header: ASNumTypes.h:121

Description

ASBool

Syntax

typedef ASUns16 ASBool;

Returned From

Used By

Used In

ASByte

Header: ASExpT.h:187

Syntax

typedef ASUns8 ASByte;

ASByteCount

Header: ASExpT.h:117

Description

A byte count value for use in ASProcStmRdExHandler and ASFileSysItemProps.

Syntax

typedef ASUns32 ASByteCount;

Used By

Used In

ASCallback

Header: CoreExpT.h:199

Syntax

typedef void *ASCallback;

ASCoord

Header: ASExpT.h:264

Description

A coordinate for a point in device space, for use in mouse click callbacks. Values are conditionally compiled as 16-bit or 32-bit integers, depending on the Acrobat version.

Related Methods

ASGetSecs ASIsValidUTF8

Syntax

typedef ASInt16 ASCoord;

ASCoord

Header: ASExpT.h:278

Description

A coordinate for a point in device space, for use in mouse click callbacks. Values are conditionally compiled as 16-bit or 32-bit integers, depending on the Acrobat version.

Related Methods

ASGetSecs ASIsValidUTF8

Syntax

typedef ASInt32 ASCoord;

Used In

ASCount

Header: ASExpT.h:184

Description

A numeric count value.

Syntax

typedef ASUns32 ASCount;

Returned From

Used By

Used In

ASDuration

Header: ASExpT.h:163

Syntax

typedef ASInt32 ASDuration;

Used By

ASEnum16

Header: CoreExpT.h:75

Description

2-byte enumeration with values from 0 to 32,767, used in data structures.

Syntax

typedef ASInt16 ASEnum16;

ASEnum16

Header: CoreExpT.h:91

Description

2-byte enumeration with values from 0 to 32,767, used in data structures.

Syntax

typedef ASInt16 ASEnum16;

Used In

ASEnum8

Header: CoreExpT.h:70

Description

1-byte enumeration with values from 0 to 127, used in data structures.

Syntax

typedef ASInt16 ASEnum8;

ASEnum8

Header: CoreExpT.h:86

Syntax

typedef ASUns8 ASEnum8;

Used In

ASFlagBits

Header: ASExpT.h:139

Description

A flag-bits value.

Syntax

typedef ASUns32 ASFlagBits;

Returned From

Used By

Used In

ASFract

Header: ASExpT.h:1186

Description

Definition of ASFract.

Syntax

typedef ASInt32 ASFract;

ASInt16

Header: ASNumTypes.h:49

Description

2-byte signed short numeric value.

Syntax

typedef short int ASInt16, *ASInt16P;

Returned From

Used By

Used In

ASInt32

Header: ASNumTypes.h:54

Description

4-byte signed long numeric value.

Syntax

typedef int ASInt32, *ASInt32P;

Returned From

Used By

Used In

ASInt64

Header: ASNumTypes.h:59

Description

8-byte signed long numeric value.

Syntax

typedef signed long long int ASInt64;

Returned From

Used By

Used In

ASInt8

Header: ASNumTypes.h:45

Description

1-byte signed char value.

Syntax

typedef signed char ASInt8, *ASInt8P;

Returned From

ASIntOrPtr

Header: ASNumTypes.h:99

Syntax

typedef intptr_t ASIntOrPtr;

ASMaskBits

Header: ASExpT.h:160

Syntax

typedef ASUns32 ASMaskBits;

Used By

ASReportType

Header: ASExtraExpT.h:364

Description

Used in an ASReportProc to indicate what kind of information is being reported.

For value options see ASReportOptions.

Syntax

typedef ASEnum16 ASReportType;

Used By

ASSize_t

Header: ASNumTypes.h:148

Syntax

typedef size_t ASSize_t;

Returned From

Used By

Used In

ASSmallCount

Header: ASExpT.h:192

Description

A signed int value. Negative values are never used.

Syntax

typedef ASInt16 ASSmallCount;

ASSmallCount

Header: ASExpT.h:282

Syntax

typedef ASUns16 ASSmallCount;

Used By

ASTArraySize

Header: ASExpT.h:215

Description

A numeric array size value for use in AS and Cos-level I/O methods and data structures.

Syntax

typedef ASInt32 ASTArraySize;

ASTArraySize

Header: ASExpT.h:284

Syntax

typedef ASUns32 ASTArraySize;

Returned From

Used By

Used In

ASTCount

Header: ASExpT.h:239

Description

A numeric count value for use in stream methods.

Syntax

typedef ASInt32 ASTCount;

ASTCount

Header: ASExpT.h:286

Syntax

typedef ASUns32 ASTCount;

Returned From

Used By

Used In

ASTVersion

Header: ASExpT.h:223

Description

A cryptographic version number.

Syntax

typedef ASInt32 ASTVersion;

ASTVersion

Header: ASExpT.h:285

Syntax

typedef ASUns32 ASTVersion;

Returned From

Used By

ASUns16

Header: ASNumTypes.h:86

Description

2-byte unsigned short numeric value.

Syntax

typedef unsigned short int ASUns16, *ASUns16P;

Returned From

Used By

Used In

ASUns32

Header: ASNumTypes.h:91

Description

4-byte unsigned long numeric value.

Syntax

typedef unsigned int ASUns32, *ASUns32P;

Returned From

Used By

Used In

ASUns64

Header: ASNumTypes.h:96

Description

8-byte unsigned long numeric value.

Syntax

typedef unsigned long long int ASUns64;

Returned From

Used By

Used In

ASUns8

Header: ASNumTypes.h:82

Description

1-byte unsigned char value.

Syntax

typedef unsigned char ASUns8, *ASUns8P;

Returned From

Used By

Used In

ASUnsOrPtr

Header: ASNumTypes.h:101

Syntax

typedef uintptr_t ASUnsOrPtr;

OPAQUE_32_BITS

Header: CoreExpT.h:114

Syntax

typedef ASInt32 OPAQUE_32_BITS;

Used In

General Callback Signatures

ASCancelProc

Header: ASExpT.h:3699

Description

This callback replaces CancelProc().

A callback to check for cancelling operations. An ASCancelProc() is typically passed to some method that takes a long time to complete. At frequent intervals, the method calls the ASCancelProc(). If it returns true, the method cancels its operation; if it returns false, it continues.

Related Methods

PDFLPrintCancelProc (Only available with the PDF Library SDK)

Syntax

ASBool ASCancelProc(void *clientData);

Parameters

clientData
IN/OUT User-supplied data that was passed to the method that uses the ASCancelProc().

Returns

true if the processing is to be canceled, false otherwise.

Used By

Used In

ASProgressProc

Header: ASExpT.h:3706

Syntax

ASBool ASProgressProc(float current, const char *name, ASInt32 /* it's a PDFLFlattenProgressMarker (see PDFLPrint.h) */ stage, void *clientData);

Used In

ASReportProc

Header: ASExtraExpT.h:400

Description

A report proc can be used to report errors, warnings, and other messages to the user. Normally a report proc will use a dialog to notify the user of an error, but in some contexts (such as during batch processing) it may either log the error or warning to a file or ignore it.

It is this callback's responsibility to destroy all objects passed to it, and it may do so at any time.

Syntax

void ASReportProc(ASReportType reportType, ASInt32 errorCode, ASText message, ASText replacementText, ASCab moreInfo, void *reportProcData);

Parameters

reportType
The type of information that is reported.
errorCode
An error code defined by the system or by ASRegisterErrorString(). If message is not NULL, the error code can be 0.
message
Specifies the text the user should read. If the message field is NULL, the system will retrieve the message associated with the errorCode. If both message and errorCode are specified, the message argument is used.
replacementText
If this replacement text is not NULL, the system will attempt to replace the string '%s' in the message with the replacement text. This applies whether the text is specified via the message argument or retrieved from the system using the errorCode argument.
moreInfo
Not currently used. The report proc will destroy this cabinet immediately.
reportProcData
A pointer to the data associated with the report proc (which should be passed in when the report proc is acquired).

Used In

PMBeginOperationProc

Header: ASExpT.h:3551

Description

A callback used in ASProgressMonitor that initializes the progress monitor and displays it with a current value of zero. This method must be called first when the progress monitor is used.

Related Methods

Syntax

void PMBeginOperationProc(void *clientData);

Parameters

clientData
IN/OUT User-supplied data that was passed in the call to whatever API method required the progress monitor.

Used In

PMEndOperationProc

Header: ASExpT.h:3563

Description

A callback used in ASProgressMonitor that draws the progress monitor with its current value set to the progress monitor's duration (a full progress monitor), then removes the progress monitor from the display.

Related Methods

Syntax

void PMEndOperationProc(void *clientData);

Parameters

clientData
IN/OUT User-supplied data that was passed in the call to whatever API method required the progress monitor.

Used In

PMGetCurrValueProc

Header: ASExpT.h:3616

Description

A callback used in ASProgressMonitor that gets the progress monitor's duration, set by the most recent call to the progress monitor's PMSetCurrValueProc().

Related Methods

Syntax

ASDuration PMGetCurrValueProc(void *clientData);

Parameters

clientData
IN/OUT User-supplied data that was passed in the call to whatever API method required the progress monitor.

Used In

PMGetDurationProc

Header: ASExpT.h:3605

Description

A callback used in ASProgressMonitor that gets the progress monitor's duration, set by the most recent call to the progress monitor's PMSetDurationProc().

Related Methods

Syntax

ASDuration PMGetDurationProc(void *clientData);

Parameters

clientData
IN/OUT User-supplied data that was passed in the call to whatever API method required the progress monitor.

Returns

The progress monitor's maximum value.

Used In

PMSetCurrValueProc

Header: ASExpT.h:3593

Description

A callback used in ASProgressMonitor that sets the current value of the progress monitor and updates the display. The allowed value ranges from 0 (empty) to the value passed to setDuration. For example, if the progress monitor's duration is 10, the current value must be between 0 and 10, inclusive.

Related Methods

Syntax

void PMSetCurrValueProc(ASDuration currValue, void *clientData);

Parameters

currValue
IN/OUT The progress monitor's current value.
clientData
IN/OUT User-supplied data that was passed in the call to whatever API method required the progress monitor.

Used In

PMSetDurationProc

Header: ASExpT.h:3578

Description

A callback used in ASProgressMonitor that sets the value that corresponds to a full progress monitor display. The progress monitor is subsequently filled in by setting its current value. This method must be called before you can set the progress monitor's current value.

Related Methods

Syntax

void PMSetDurationProc(ASDuration duration, void *clientData);

Parameters

duration
IN/OUT The maximum value the progress monitor will be allowed to have.
clientData
IN/OUT User-supplied data that was passed in the call to whatever API method required the progress monitor.

Used In

PMSetTextProc

Header: ASExpT.h:3631

Description

A callback within ASProgressMonitorRec that sets the text string that is displayed by the progress monitor.

The built-in document progress monitor (see AVAppGetDocProgressMonitor()) makes a copy of the text. As such, it is the client's responsibility to destroy it.

Syntax

void PMSetTextProc(ASText text, void *clientData);

Parameters

text
IN/OUT The string to display.
clientData
IN/OUT A pointer to the data associated with the progress monitor (which should be passed in with the progress monitor).

Used In

General Structures

OPAQUE_64_BITS

Header: CoreExpT.h:115

Syntax

struct OPAQUE_64_BITS {
} OPAQUE_64_BITS;

Used In

_t_ASStatusMonitorProcs

Header: ASExtraExpT.h:407

Syntax

struct _t_ASStatusMonitorProcs {
ASSize_t size;
The size of the structure.
A pointer to the progress monitor.
void *progMonClientData;
A pointer to client data, which can be of any type.
ASCancelProc cancelProc;

This call has been replaced by ASCancelProc().

A callback to check for cancelling operations. An ASCancelProc is typically passed to some method that takes a long time to complete. At frequent intervals, the method calls the ASCancelProc. If it returns true, the method cancels its operation; if false, it continues.

void *cancelProcClientData;
A pointer to client data for the cancel procedure.
ASReportProc reportProc;
The report procedure.
void *reportProcClientData;
A pointer to client data for the report procedure.
ASProgressProc progressProc;
A pointer to a callback function for monitoring progress.
void *progressProcClientData;
} ASStatusMonitorProcsRec, *ASStatusMonitorProcs;

Used By

Used In

_t_ProgressMonitor

Header: ASExpT.h:3647

Description

Replaced by ASProgressMonitor.

A data structure containing callbacks that implement a progress monitor. The callbacks implement the progress monitor functions. A progress monitor is used to display progress during potentially time-consuming operations. Progress monitors are included as parameters in many API calls. Acrobat's built-in progress monitor can be obtained by calling AVAppGetDocProgressMonitor().

Syntax

struct _t_ProgressMonitor {
ASSize_t size;
The size of the data structure. It must be set to sizeof(ProgressMonitorRec).
PMBeginOperationProc beginOperation;
Initialize the progress monitor and display it with a current value of zero.
PMEndOperationProc endOperation;
Draw the progress monitor with its current value set to the progress monitor's duration (a full progress monitor).
PMSetDurationProc setDuration;
Set the progress monitor's duration.
PMSetCurrValueProc setCurrValue;
Set the current value of the progress monitor and update the display.
PMGetDurationProc getDuration;
Get the progress monitor's duration.
PMGetCurrValueProc getCurrValue;
Get the progress monitor's duration.
PMSetTextProc setText;
Set the text string that is displayed by the progress monitor.
} ASProgressMonitorRec, *ASProgressMonitor;

Used By

Used In

_t_Quad

Header: ASExpT.h:1163

Description

A structure that represents a quadrilateral defined by four corner points.

Note: The coordinate numeric types changed in Acrobat 6.

Syntax

struct _t_Quad {
ASCoord tlh, tlv;
ASCoord trh, trv;
ASCoord blh, blv;
ASCoord brh, brv;
} Quad, *QuadP;

General Functions

ASDebug

Header: ASProcs.h:1042

Description

For internal use only.

Syntax

void *ASDebug(ASInt32 op, void *parm, ASTArraySize parmLen, void *clientData);