The options in this category provide tools one may use to identify HTML links contained within the document, and to format those links so as to be easily recognizable to the reader of the document. If you include in your print file the text "www.microsabio.com" and do not turn on the Links.Enabled option below, then the phrase "www.microsabio.com" will appear in the PDF document as regular text. If you turn on the Links.Enable switch, however, www.microsabio.com will (a) appear in the document as highlighted text, and (b) will function as a live link—i.e., the user may click on the link and will be directed to the appropriate website.
Name |
Values |
Description |
PDFXv3 |
---|---|---|---|
Enabled |
Boolean |
This will detect URL and mail links. To be valid, links must be valid and occupy a single line of the page. Embedded links cannot be recognized (e.g. 'Click Here'). Default = False |
Analize |
DetectFiles |
Boolean |
Links to files; must be valid and contain a fully qualified path. Default = False |
Files.Analize |
CheckExistance |
Boolean |
Check a links validity as part of the recognition and PDF page inclusion process. Default = False |
Files.Check |
Border
This sub-property group (i.e. Links.Border.xxx) defines how the detected links and files will be highlighted in the text.
Name |
Values |
Description |
PDFXv3 |
---|---|---|---|
Type |
0 (None) 1 (Underline) 2 (Rectangle) |
Specifies the type of links border. Default = 0 (None) |
(same) |
Style |
0 (Solid) 1 (Dashed) 2 (Dotted) |
Default = 0 (Solid) |
(same) |
Color |
Integer |
Specifies RGB value of color for links border. To specify this value You may use the &hBBGGRR hex format (e.g. &hff0000 for blue) Default = 255 or &h0000ff (red color) |
(same) |
Width |
5 to 50 |
Defines the width of links border. Value is specified in tenth of millimeters. Default = 10 |
(same) |
Examples
The following directives turn on PDFX's options for recognizing URLs and turning them into links, as well as filespecs (if they exist).
//;define the link display attributes
//PDFX,Links.Border.Type,Underline
//PDFX,Links.Border.Style,Solid
//PDFX,Links.Border.Color,&hff0000
//PDFX,Links.Border.Width,15
//;Enable link analysis (v3 syntax, also ok for v5)
//PDFX,Links.Analize,1
//PDFX,Links.Files.Analize,1
//PDFX,Links.Files.Check,1
The following version uses the PDFXv5+ syntax to enable the link analysis:
//;v5 syntax for enabling links (ignored by v3)
//PDFX,Links.Enabled,true
//PDFX,Links.DetectFiles,true
//PDFX,Links.CheckExistance,true
Compatibility
PDFXv3, v5 and v9, with slight syntax changes. V3 syntax is upward compatible to V5+, but not vice versa.