Class AnnotationLink

  • All Implemented Interfaces:
    java.lang.Cloneable

    public final class AnnotationLink
    extends PDFAnnotation

    A subtype new PDFAnnotation that performs the specified action when clicked. This can be used to create an HTML-style hyperlink, play a sound, or perform some other PDFAction.

    Since:
    2.0
    • Method Detail

      • setAction

        public void setAction​(PDFAction action)
        Set the action for this hyperlink
      • getAction

        public PDFAction getAction()
        Return the action performed by this hyperlink
      • setStyle

        public void setStyle​(PDFStyle style)

        Set the style for this hyperlink annotation. Parameters from the style that are used include LineColor, DashPattern, LineWeighting and FormStyle (although Acrobat 4 and earlier will ignore the FormStyle)

        Alternatively the style may be null to prevent this link having any visible appearance on the page

        Parameters:
        style - the style to draw the link in - may be null
      • setCorners

        public void setCorners​(float x1,
                               float y1,
                               float x2,
                               float y2,
                               float x3,
                               float y3,
                               float x4,
                               float y4)

        Set the four corners (x1,y1) (x2,y2) (x3,y3) (x4,y4) of the quadrilateral that encompasses the text underlying this annotation. This can be used to create the annotation on an angle, although viewers prior to Acrobat 7.0 will not recognise the rotation. Since 2.11.6 there is no need to call setRectangle(org.faceless.pdf2.LayoutBox.Box, float, float) as well as this method.

        While the coordinates can describe any quadrilateral, some viewers may behave incorrectly if it is not rectangular (eg Preview.app on OS X).

        Parameters:
        x1 - the X co-ordinate of the bottom-left corner of the text
        y1 - the Y co-ordinate of the bottom-left corner of the text
        x2 - the X co-ordinate of the bottom-right corner of the text
        y2 - the Y co-ordinate of the bottom-right corner of the text
        x3 - the X co-ordinate of the top-left corner of the text
        y3 - the Y co-ordinate of the top-left corner of the text
        x4 - the X co-ordinate of the top-right corner of the text
        y4 - the Y co-ordinate of the top-right corner of the text
        Since:
        2.4
      • setCorners

        public void setCorners​(float[] corners)

        Set a series of corners of the quadrilateral(s) that encompass the text underlying this annotation. The points are specified in the same order as for the other setCorners() method. The supplied array must be 8xn long, specifying the n quadrilaterals that make up the annotation.

        While the coordinates can describe any sequence of quadrilaterals, some viewers may behave incorrectly if they are not all rectangular (e.g. Preview.app on OS X).

        Parameters:
        corners - an array of 8xn values, each group of 8 specified as (x1,y1, x2,y2, x3,y3, x4,y4)
        Since:
        2.11.6
      • setCorners

        public void setCorners​(java.awt.Shape shape)

        Attempt to set the corners of the annotation to the specified shape. This method will attempt to break the shape up into quadrilaterals, as required by the PDF specification. If for any reason the specified Shape cannot be split (and currently, only areas with no holes can be), then this method will throw an IllegalArgumentException.

        While the shape can be any shape, some viewers may behave incorrectly if it is not rectangular (e.g. Preview.app on OS X).

        Since:
        2.18.2
      • setRectangle

        public void setRectangle​(float x1,
                                 float y1,
                                 float x2,
                                 float y2)
        Description copied from class: PDFAnnotation
        Set the rectangle for the annotation - where it is on the page. Every annotation must have a rectangle set - if it's not set when the document is written, it's forced to (0,0,0,0).
        • For AnnotationLink and AnnotationStamp annotations, this is the rectangle containing the hyperlink area or stamp.
        • For AnnotationNote annotations, whether this method adjusts the location of the icon or the popup window depends on whether the annotation is closed or open at the time of the call to this method. When closed, the icon is positioned at x1,y2

        Note that all co-ordinates are in absolute page co-ordinates. This means they are measured in points from the bottom-left hand corner of the page, regardless of any calls to PDFPage.rotate(float, float, double) or PDFPage.setUnits(float, int) that have been made. This restriction is part of the PDF specification.

        Overrides:
        setRectangle in class PDFAnnotation
        Parameters:
        x1 - the X co-ordinate of the bottom-left corner of the rectangle
        y1 - the Y co-ordinate of the bottom-left corner of the rectangle
        x2 - the X co-ordinate of the top-right corner of the rectangle
        y2 - the Y co-ordinate of the top-right corner of the rectangle
      • getCornersAsShape

        public java.awt.Shape getCornersAsShape()
        Return the outline of the annotation as a shape
        Since:
        2.23.2
      • getCorners

        public float[] getCorners()
        Return the corners of the Annotation as specified by setCorners().
        Returns:
        an array of 8xn points as set by setCorners()
        Since:
        2.4
      • toString

        public java.lang.String toString()
      • putLiteral

        public void putLiteral​(java.lang.String key,
                               java.lang.String tokens)
        Put a literal token sequnce. For debugging
        Parameters:
        key - the key
        tokens - the token sequence, eg "true" or "/foo" or "[/Foo/Bar]". No refs, just direct objects.
      • clone

        protected java.lang.Object clone()
        Overrides:
        clone in class java.lang.Object