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

DynaPDF Manual - Page 109

Previous Page 108   Index   Next Page 110

Function Reference
Page 109 of 750
AddArticle
Syntax:
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.
Remarks:
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.
AddBookmark
Syntax:
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
LBOOL Open)
// 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
file.
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