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

DynaPDF Manual - Page 734

Previous Page 733   Index   Next Page 735

Function Reference
Page 734 of 750
Watermark annotations can be shared on multiple pages. To place the annotation on other pages call
AddAnnotToPage().
Return values:
If the function succeeds the return value is the annotation handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
WebLink
Syntax:
SI32 pdfWebLink(
const PPDF* IPDF, // Instance pointer
double PosX,
// X-Coordinate of bounding rectangle
double PosY,
// Y-Coordinate of bounding rectangle
double Width,
// Width of bounding rectangle
double Height,
// Height of bounding rectangle
const char* URL)
// URL defined as null-terminated 7 bit ASCII string
The function inserts a web link onto the current open page. The parameter URL holds the URL
defined as 7 bit ASCII string. A uniform resource locator (URL) is a string that resolves to a resource
on the internet - typically a file that is the destination of a hypertext link, although it can also resolve
to a query or other entity. A web link opens the standard browser to view the resource by default.
The full version of Adobes Acrobat enables you also to embed a reverenced html resource in your
document.
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.
Remarks:
This function is implemented in an Ansi and Unicode compatible version. Because the URL must be
defined as 7 bit ASCII string, a Unicode URL must not contain characters outside of 7 bit ASCII.
Return values:
If the function succeeds the return value is the annotation handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
 

Previous topic: WatermarkAnnot

Next topic: WriteAngleText