DynaPDF Manual - Page 671

Previous Page 670   Index   Next Page 672

Function Reference

Page 671 of 821

the contents of an annotation. Note also that DynaPDF does not use the rich text to create the

appearance stream. However, the rich text should still coincide with the annotations content.

Return values:

If the function succeeds the return value is 1. If the function fails the return value is 0.

SetAnnotSubject

Syntax:

LBOOL pdfSetAnnotSubject(

const PPDF* IPDF,

// Instance pointer

UI32 Handle,

// Annotation handle

const char* Value)

// The subject to be set

The function sets or changes the optional subject string of an annotation. The subject is defined since

PDF 1.5. The function adjusts the PDF version automatically if it is lower than PDF 1.5.

The annotation types atFileLink, atPageLink, atPopUp, and atWebLink do not support a subject

string. The function returns with an error when trying to set the subject on these annotation types.

If the parameter Value is NULL or if it contains an empty string the subject string is deleted in the

annotation.

Remarks:

This function is implemented in an Ansi and Unicode compatible variant.

Return values:

If the function succeeds the return value is 1. If the function fails the return value is 0.

SetBBox

Syntax:

LBOOL pdfSetBBox(

const PPDF* IPDF,

// Instance pointer

TPageBoundary Boundary, // Bounding box

double LeftX,

// lower left x

double LeftY,

// lower left y

double RightX,

// upper-right x

double RightY)

// upper-right y

typedef enum

{

pbArtBox,

// Art box

pbBleedBox, // Bleed box

pbCropBox,

// Crop box

pbTrimBox,

// Trim box

pbMediaBox

// Media box

}TPageBoundary;

The function sets a specific bounding box of the current open page. A PDF page may be prepared

either for a finished medium, such as a sheet of paper, or as part of a prepress process in which the

Previous topic: SetAnnotQuadPoints, SetAnnotString

Next topic: Bounding boxes:, SetBidiMode