Class Link
A link annotation represents either a hypertext link to a destination elsewhere in the document or an action to be performed.
Implements
Inherited Members
Namespace: pdftron.PDF.Annots
Assembly: PDFTronDotNet.dll
Syntax
public class Link : Annot, IDisposable
Constructors
Link(Annot)
Creates a Link annotation and initialize it using given annotation object.
Declaration
public Link(Annot ann)
Parameters
| Type | Name | Description |
|---|---|---|
| Annot | ann | the annot |
Remarks
The constructor does not copy any data, but is instead the logical equivalent of a type cast.
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
Link(Obj)
Creates a Link annotation and initialize it using given Cos/SDF object.
Declaration
public Link(Obj d)
Parameters
| Type | Name | Description |
|---|---|---|
| Obj | d | the d |
Remarks
The constructor does not copy any data, but is instead the logical equivalent of a type cast.
Methods
Create(SDFDoc, Rect)
Creates a new Link annotation.
Declaration
public static Link Create(SDFDoc doc, Rect pos)
Parameters
| Type | Name | Description |
|---|---|---|
| SDFDoc | doc | A document to which the annotation is added. |
| Rect | pos | A rectangle specifying the annotation's bounds, specified in user space coordinates. |
Returns
| Type | Description |
|---|---|
| Link | A new Link annotation. |
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
Create(SDFDoc, Rect, Action)
Creates a new Link annotation.
Declaration
public static Link Create(SDFDoc doc, Rect pos, Action action)
Parameters
| Type | Name | Description |
|---|---|---|
| SDFDoc | doc | A document to which the annotation is added. |
| Rect | pos | A rectangle specifying the annotation's bounds, specified in user space coordinates. |
| Action | action | Action for the link annotation. |
Returns
| Type | Description |
|---|---|
| Link | A new Link annotation. |
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
~Link()
Releases all resources used by the Link
Declaration
protected ~Link()
GetAction()
Gets the Action of the Linked Annotation.
Declaration
public Action GetAction()
Returns
| Type | Description |
|---|---|
| Action | An Action object that denotes the action of the linked annotation. |
Remarks
The return value is an action that shall be performed when the link annotation is activated
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
GetHighlightingMode()
Gets the HighlightingMode Linked Annotation.
Declaration
public Link.HighlightingMode GetHighlightingMode()
Returns
| Type | Description |
|---|---|
| Link.HighlightingMode | The HighLighting mode represented as an entry of the enum "HighlightingMode". |
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
GetQuadPoint(int)
Gets the QuadPoint located at a certain index of the QuadPoint array of the Link annotation.
Declaration
public QuadPoint GetQuadPoint(int idx)
Parameters
| Type | Name | Description |
|---|---|---|
| int | idx | the idx |
Returns
| Type | Description |
|---|---|
| QuadPoint | The QuadPoint located at a certain index of the QuadPoint array of the Link annotation. |
Remarks
An array of n QuadPoints specifying the coordinates of n quadrilaterals in default user space that comprise the region in which the link should be activated. The coordinates specifying the four vertices of the quadrilateral in counterclockwise order. For orientation purposes, such as when applying an underline border style, the bottom of a quadrilateral is the line formed by p1 and p2 of the QuadPoint. QuadPoints shall be ignored if any coordinate in the array lies outside the region specified by Rect.
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
GetQuadPointCount()
Gets the number of QuadPoints in the QuadPoints array of the Link annotation.
Declaration
public int GetQuadPointCount()
Returns
| Type | Description |
|---|---|
| int | The number of QuadPoints. |
Remarks
An array of n QuadPoints specifying the coordinates of n quadrilaterals in default user space that comprise the region in which the link should be activated. The coordinates specifying the four vertices of the quadrilateral in counterclockwise order. For orientation purposes, such as when applying an underline border style, the bottom of a quadrilateral is the line formed by p1 and p2 of the QuadPoint. QuadPoints shall be ignored if any coordinate in the array lies outside the region specified by Rect.
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
RemoveAction()
Removes a link annotation's action.
Declaration
public void RemoveAction()
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
SetAction(Action)
Sets the Action of the Linked Annotation. (Optional; PDF 1.1 )
Declaration
public void SetAction(Action action)
Parameters
| Type | Name | Description |
|---|---|---|
| Action | action | An Action object that denotes the action of the linked annotation. |
Remarks
The parameter is an action that shall be performed when the link annotation is activated
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
SetHighlightingMode(HighlightingMode)
Sets the HighlightingMode Linked Annotation. (Optional; PDF 1.2 )
Declaration
public void SetHighlightingMode(Link.HighlightingMode mode)
Parameters
| Type | Name | Description |
|---|---|---|
| Link.HighlightingMode | mode | The HighLighting mode represented as an entry of the enum "HighlightingMode". |
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |
SetQuadPoint(int, QuadPoint)
Set the QuadPoint to be located at a certain index of the QuadPoint array of the Link annotation. (Optional; PDF 1.6 )
Declaration
public void SetQuadPoint(int idx, QuadPoint qp)
Parameters
| Type | Name | Description |
|---|---|---|
| int | idx | the idx |
| QuadPoint | qp | the qp |
Remarks
An array of n QuadPoints specifying the coordinates of n quadrilaterals in default user space that comprise the region in which the link should be activated. The coordinates specifying the four vertices of the quadrilateral in counterclockwise order. For orientation purposes, such as when applying an underline border style, the bottom of a quadrilateral is the line formed by p1 and p2 of the QuadPoint. QuadPoints shall be ignored if any coordinate in the array lies outside the region specified by Rect.
Exceptions
| Type | Condition |
|---|---|
| PDFNetException | PDFNetException the PDFNet exception |