Links

Defining links in PDF ties a certain area in a document to a link. Pressing that area leads to the target of the link.

The PDFWriter class allows you to add link through calling the following method:

EStatusCode AttachURLLinktoCurrentPage(const string& inURL,const PDFRectangle& inLinkClickArea);

The AttachURLLinkToCurrentPage method will attach a certain area in a page to the input URL. The page which the link will be created on is the next page that will be written (By calling either WritePage or WritePageAndRelease).

It accepts two parameters:

• inURL a string URL.
• inLinkClickArea a rectangle defining the area where in a click would trigger accessing the URL. (on most system this would mean that a browser window is opened).

Note that PDF does not contain a native method for attaching links to text. Hence to place a link on a text you must posit the link on the area of the text.

The following is a simple usage example:

pdfWriter.AttachURLLinktoCurrentPage("http://www.soundcloud.com",PDFRectangle(90.024,200,367.524,375));

This call attached the URL www.soundcloud.com, to the area defined by the rectangle [90.024, 200, 367.524, 375].

• If you are looking to a attach a link to a certain area of text, you may want to be able to measure that text. For this use the text measurement capabilities of the library.
• If it is an image that you are looking to attach a link to, then it will be useful to know the measures of that image. The library has something for that as well.

For a complete code example see Links Test