Monkeybread Software - DynaPDF Manual

DynaPDF Manual - Page 200

Function Reference

Page 200 of 860

ChangeAnnotName

Syntax:

SI32 pdfChangeAnnotName(

const PPDF* IPDF,

// Instance pointer

UI32 Handle,

// Annotation handle

const char* Name)

// Annotation name or NULL

This function changes or deletes the optional unique name of an annotation. The parameter Handle

must be a valid annotation handle. If the parameter Name contains an empty string or if it is set to

NULL, the name will be deleted. The annotation name must be a unique string so that the

annotation can be identified in JavaScript actions. The string could be a GUIID, a hash, or any other

string that uniquely identifies the annotation.

Remarks:

This function is available in an Ansi and Unicode compatible version.

Return values:

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

ChangeAnnotPos

Syntax:

SI32 pdfChangeAnnotPos(

const PPDF* IPDF, // Instance pointer

UI32 Handle,

// Annotation handle

double PosX,

// X-Coordinate of the annotation

double PosY,

// Y-Coordinate of the annotation

double Width,

// Width in unscaled units

double Height)

// Height in unscaled units

This function changes the position and size of an annotation. The bounding box of annotations is

defined in bottom up coordinates. The reference point is Left, Bottom of the bounding box that can be

retrieved by GetAnnotBBox(), GetAnnotEx(), or GetPageAnnotEx(), for example.

The annotation extends to top, right when scaling to a larger size. The function rebuilds the

appearance stream after changing the position or size if possible.

Note that the function considers the current coordinate system (bottom up or top down). In order to

change the position or size of an existing annotation, the coordinate system should be set to

pcBottomUp beforehand (see SetPageCoords() for further information).

Return values:

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

Previous topic: CaretAnnot