DynaPDF Manual - Page 113

Previous Page 112   Index   Next Page 114

Function Reference
Page 113 of 777
SI32 pdfAddArticle(
const PPDF* IPDF, // Instance pointer
double PosX,
// X-Coordinate of the Article
double PosY,
// Y-Coordinate of the Article
double Width,
// Width in unscaled units
double Height)
// Height in unscaled units
This function creates a new article and adds it to the currently open article thread that must be
created with CreateArticleThread() beforehand.
Some types of document 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.
The sequential flow of an article is defined by an article thread; the individual content items that
make up the article are called beads on the thread. PDF viewer applications such as Adobe’s Acrobat
provide navigation facilities to allow the user to follow a thread from one bead to the next.
Due to a bug in Acrobat 6 articles can cause a zoom out. The pages of a document appear then as
small thumb nails.
Return values:
If the function succeeds the return value is the handle of the article, a value greater or equal zero. If
the function fails the return value is a negative error code.
SI32 pdfAddBookmark(
const PPDF* IPDF,
// Instance pointer
const char* Title, // Title of the bookmark
SI32 Parent,
// Parent bookmark or -1, see description
UI32 DestPage,
// Destination page
// Open or close the node when it contains children
This function adds a bookmark to the global outline tree of the document. It sets also the page mode
to pmUseOutlines (see SetPageMode()). If the outline tree should not be shown when opening the
document, then set the page mode back to pmUseNone or any other value before closing the PDF
Parent can be a handle of another bookmark if it should be added as a child of this bookmark. If
Parent is set to -1 the bookmark is added as a root node.

Previous topic: AddAnnotToPage

Next topic: AddBookmarkEx