Class PdfFreeTextAnnotation

    • Constructor Detail

      • PdfFreeTextAnnotation

        public PdfFreeTextAnnotation​(Rectangle rect,
                                     PdfString contents)
        Creates new instance
        Parameters:
        rect - - rectangle that specifies annotation position and bounds on page
        contents - - the displayed text
    • Method Detail

      • getSubtype

        public PdfName getSubtype()
        Description copied from class: PdfAnnotation
        Gets a PdfName which value is a subtype of this annotation. See ISO-320001 12.5.6, "Annotation Types" for the reference to the possible types.
        Specified by:
        getSubtype in class PdfAnnotation
        Returns:
        subtype of this annotation.
      • getDefaultStyleString

        public PdfString getDefaultStyleString()
      • getDefaultAppearance

        public PdfString getDefaultAppearance()
        The default appearance string that shall be used in formatting the text. See ISO-32001 12.7.3.3, "Variable Text".
        Returns:
        a PdfString that specifies the default appearance, or null if default appereance is not specified.
      • setDefaultAppearance

        public PdfFreeTextAnnotation setDefaultAppearance​(PdfString appearanceString)
        The default appearance string that shall be used in formatting the text. See ISO-32001 12.7.3.3, "Variable Text".
        Parameters:
        appearanceString - a PdfString that specifies the default appearance.
        Returns:
        this PdfFreeTextAnnotation instance.
      • getCalloutLine

        public PdfArray getCalloutLine()
      • getLineEndingStyle

        public PdfName getLineEndingStyle()
      • getJustification

        public int getJustification()
        A code specifying the form of quadding (justification) that is used in displaying the annotation's text: 0 - Left-justified, 1 - Centered, 2 - Right-justified. Default value: 0 (left-justified).
        Returns:
        a code specifying the form of quadding (justification), returns the default value if not explicitly specified.
      • setJustification

        public PdfFreeTextAnnotation setJustification​(int justification)
        A code specifying the form of quadding (justification) that is used in displaying the annotation's text: 0 - Left-justified, 1 - Centered, 2 - Right-justified. Default value: 0 (left-justified).
        Parameters:
        justification - a code specifying the form of quadding (justification).
        Returns:
        this PdfFreeTextAnnotation instance.
      • getBorderStyle

        public PdfDictionary getBorderStyle()
        The dictionaries for some annotation types (such as free text and polygon annotations) can include the BS entry. That entry specifies a border style dictionary that has more settings than the array specified for the Border entry (see PdfAnnotation.getBorder()). If an annotation dictionary includes the BS entry, then the Border entry is ignored. If annotation includes AP (see PdfAnnotation.getAppearanceDictionary()) it takes precedence over the BS entry. For more info on BS entry see ISO-320001, Table 166.
        Returns:
        PdfDictionary which is a border style dictionary or null if it is not specified.
      • setBorderStyle

        public PdfFreeTextAnnotation setBorderStyle​(PdfDictionary borderStyle)
        Sets border style dictionary that has more settings than the array specified for the Border entry (PdfAnnotation.getBorder()). See ISO-320001, Table 166 and getBorderStyle() for more info.
        Parameters:
        borderStyle - a border style dictionary specifying the line width and dash pattern that shall be used in drawing the annotation’s border.
        Returns:
        this PdfFreeTextAnnotation instance.
      • setDashPattern

        public PdfFreeTextAnnotation setDashPattern​(PdfArray dashPattern)
        Setter for the annotation's preset dashed border style. This property has affect only if PdfAnnotation.STYLE_DASHED style was used for the annotation border style (see setBorderStyle(PdfName). See ISO-320001 8.4.3.6, "Line Dash Pattern" for the format in which dash pattern shall be specified.
        Parameters:
        dashPattern - a dash array defining a pattern of dashes and gaps that shall be used in drawing a dashed border.
        Returns:
        this PdfFreeTextAnnotation instance.
      • getRectangleDifferences

        public PdfArray getRectangleDifferences()
        A set of four numbers describing the numerical differences between two rectangles: the Rect entry of the annotation and the inner rectangle where the annotation's text should be displayed
        Returns:
        null if not specified, otherwise a PdfArray with four numbers which correspond to the differences in default user space between the left, top, right, and bottom coordinates of Rect and those of the inner rectangle, respectively.
      • setRectangleDifferences

        public PdfFreeTextAnnotation setRectangleDifferences​(PdfArray rect)
        A set of four numbers describing the numerical differences between two rectangles: the Rect entry of the annotation and the inner rectangle where the annotation's text should be displayed
        Parameters:
        rect - a PdfArray with four numbers which correspond to the differences in default user space between the left, top, right, and bottom coordinates of Rect and those of the inner rectangle, respectively. Each value shall be greater than or equal to 0. The sum of the top and bottom differences shall be less than the height of Rect, and the sum of the left and right differences shall be less than the width of Rect.
        Returns:
        this PdfFreeTextAnnotation instance.
      • getBorderEffect

        public PdfDictionary getBorderEffect()
        A border effect dictionary that specifies an effect that shall be applied to the border of the annotations.
        Returns:
        a PdfDictionary, which is a border effect dictionary (see ISO-320001, Table 167).
      • setBorderEffect

        public PdfFreeTextAnnotation setBorderEffect​(PdfDictionary borderEffect)
        Sets a border effect dictionary that specifies an effect that shall be applied to the border of the annotations.
        Parameters:
        borderEffect - a PdfDictionary which contents shall be specified in accordance to ISO-320001, Table 167.
        Returns:
        this PdfFreeTextAnnotation instance.
      • getRotation

        public PdfNumber getRotation()
        Gets the rotation angle in degrees.
        Returns:
        PdfNumber representing the clockwise rotation in degrees.
      • setRotation

        public PdfFreeTextAnnotation setRotation​(int degAngle)
        Sets the rotation angle in degrees.
        Parameters:
        degAngle - an integer representing the clockwise rotation in degrees.
        Returns:
        this PdfFreeTextAnnotation instance.