DynaPDF Manual - Page 683

Previous Page 682   Index   Next Page 684

Function Reference
Page 683 of 839
SetAnnotLineDashPattern
Syntax:
LBOOL pdfSetAnnotLineDashPattern(
const PPDF* IPDF,
// Instance pointer
UI32 Handle,
// Annotation handle
const float* Dash, // Dash array or NULL
UI32 NumValues)
// Number of array values (can be zero)
The function sets or deletes the line dash pattern of an annotation. The following annotation types
support line dash patterns:
atCircle
atInk
atLine
atPolygon
atPolyLine
atSquare
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
SetAnnotMigrationState
Syntax:
SI32 pdfSetAnnotMigrationState(
const PPDF* IPDF,
// Instance pointer
UI32 Annot,
// Handle of a markup annotation
TAnnotState State, // See below
const char* User)
// The user who sets the state
typedef enum
{
asNone,
asAccepted,
asRejected,
asCancelled,
asCompleted,
asCreateReply
}TAnnotState;
The function adds a migration state or a reply to a markup annotation. All annotation types with
exception of 3D, Link, Movie, Screen, PrinterMark, TrapNet, and Watermark are markup
annotations.
Migration states are stored in text annotations as reply to the base annotation. Further states are
stored as reply to the last reply and so on; the result is a single linked list. Because the base
annotation contains no reference to the last reply or migration state the function must search for it.
To speed up processing the function returns the handle of the text annotation so that the next state
can directly be added to this annotation. This handle is also required if a reply should be created.
 

Previous topic: SetAnnotIcon, SetAnnotLineEndStyle

Next topic: SetAnnotOpacity