Xojo Developer Conference
25/27th April 2018 in Denver.
MBS Xojo Conference
6/7th September 2018 in Munich, Germany.

DynaPDF Manual - Page 207

Previous Page 206   Index   Next Page 208

Function Reference
Page 207 of 750
CreateAnnotAP
Syntax:
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
templates.
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 whished 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
code.
CreateArticleThread
Syntax:
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 articles.
 

Previous topic: Create3DView

Next topic: CreateAxialShading