DynaPDF Manual - Page 216

Previous Page 215   Index   Next Page 217

Function Reference
Page 216 of 787
SI32 pdfCreateAnnotAP(
const PPDF* IPDF, // Instance pointer
UI32 Annot)
// Annotation handle
The function creates a user defined appearance stream for an annotation and activates it so that
arbitrary contents can be drawn into it, such as text, images, or vector graphics. An appearance
stream is a normal template in the size of the annotation. The template must be closed when finish
with EndTemplate().
Note that the template is reserved for the annotation and must not be used on pages or other
At time of publication user defined appearance streams can be created for Stamp and FreeText
annotations. However, the main application is the creation of user defined stamps. The appearance
stream of a FreeText annotation should correspond to the annotation's value.
It is allowed to insert an EMF file into a user defined appearance stream. If the contents should be
imported from an external PDF file then import the wished page with ImportPage() and place the
resulting template into this one with PlaceTemplate() or PlaceTemplateEx(). The latter version is
preferred because it considers the original page orientation and bounding boxes. See
PlaceTemplateEx() for further information.
Return values:
If the function succeeds the return value is the handle of the template that was created for the
annotation, a value greater or equal zero. If the function fails the return value is a negative error
SI32 pdfCreateArticleThread(
const PPDF* IPDF,
// Instance pointer
const char* ThreadName) // Name of the thread
This function creates a new article thread. An article thread is a container for articles which must be
created separately with AddArticle(). A document can contain an arbitrary count of article threads.
The names of the threads should be unique otherwise it is not possible to distinguish between them
in Adobe's Acrobat.
Some types of documents may contain sequences of content items that are logically connected but
not physically sequential. For example, a news story may begin on the first page of a newsletter and
run over onto one or more non-consecutive interior pages. To represent such sequences of
physically discontinuous but logically related items, a PDF document may define one or more

Previous topic: Orthographic projection, Create3DView

Next topic: CreateAxialShading

Start Chat