DynaPDF Manual - Page 320

Previous Page 319   Index   Next Page 321

Function Reference
Page 320 of 777
The file path can be defined as relative or absolute path. However, the usage of an absolute makes
only sense if it can be guaranteed that the path exist on an arbitrary system.
If the coordinate system is bottom-up the point PosX, PosY defines the lower left corner of the
bounding rectangle. If the coordinate system is top-down it defines the upper left corner.
The border of the link annotation is drawn by using the current line width, stroke color and line dash
pattern. If the link should appear without a border set the line width to zero beforehand.
When clicking on a link annotation the rectangle is highlighted, that is a simple visual effect. Several
highlight modes are supported, see SetLinkHighlightMode() for further information.
This function is implemented in an Ansi and Unicode compatible version. On Windows operating
systems the path can be defined as Ansi or Unicode string depending on whether the Ansi or
Unicode version of the function was called.
Like all file paths, the path of the Ansi version must be an UTF-8 encoded Unicode string on non-
Windows operating systems.
The function does not check whether the path is valid.
Return values:
If the function succeeds the return value is a annotation handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
SI32 pdfFindBookmark(
const PPDF* IPDF,
// Instance pointer
SI32 DestPage,
// Destination page used by the bookmark or -1
const char* Title) // The title of the bookmark or a part of it
This function searches for a bookmark in the document outline tree. If the parameter DestPage is
greater zero the function returns the handle of the first bookmark that uses this page number as
destination page.
If DestPage is smaller 1 the function returns the handle of the first bookmark that contains the
substring Title in the bookmark title. The substring Title is compared non-case-sensitive.
The parameter Title can be NULL, the function searches for bookmarks with no title in this case. To
search for the next bookmark with the same search parameters call FindNextBookmark().
It is safe to delete a found bookmark with DeleteBookmark() and continue the search run with

Previous topic: FileAttachAnnotEx, FileLink

Next topic: FindEmbeddedFile, FindField