Package net.sf.jasperreports.engine.base

Class JRBaseTextField

java.lang.Object
net.sf.jasperreports.engine.base.JRBaseElement
net.sf.jasperreports.engine.base.JRBaseTextElement
net.sf.jasperreports.engine.base.JRBaseTextField
All Implemented Interfaces:
Serializable, Cloneable, JRChangeEventsSupport, JRAnchor, JRBoxContainer, JRChild, JRCloneable, JRCommonElement, JRCommonText, JRElement, JREvaluation, JRFont, JRHyperlink, JRIdentifiable, JRParagraphContainer, JRPropertiesHolder, JRStyleContainer, JRTextAlignment, JRTextElement, JRTextField, JRVisitable
public class JRBaseTextField extends JRBaseTextElement implements JRTextField
This class is used for representing a text field.
Author:
Teodor Danciu (teodord@users.sourceforge.net)
See Also:

  • Field Details

    • PROPERTY_STRETCH_WITH_OVERFLOW

      public static final String PROPERTY_STRETCH_WITH_OVERFLOW
      See Also:

    • PROPERTY_TEXT_ADJUST

      public static final String PROPERTY_TEXT_ADJUST
      See Also:

    • textAdjust

      protected TextAdjustEnum textAdjust

    • evaluationTime

      protected EvaluationTimeEnum evaluationTime

    • pattern

      protected String pattern

    • isBlankWhenNull

      protected Boolean isBlankWhenNull

    • linkType

      protected String linkType

    • linkTarget

      protected String linkTarget

    • evaluationGroup

      protected String evaluationGroup

    • expression

      protected JRExpression expression

    • patternExpression

      protected JRExpression patternExpression

    • anchorNameExpression

      protected JRExpression anchorNameExpression

    • bookmarkLevelExpression

      protected JRExpression bookmarkLevelExpression

    • hyperlinkReferenceExpression

      protected JRExpression hyperlinkReferenceExpression

    • hyperlinkWhenExpression

      protected JRExpression hyperlinkWhenExpression

    • hyperlinkAnchorExpression

      protected JRExpression hyperlinkAnchorExpression

    • hyperlinkPageExpression

      protected JRExpression hyperlinkPageExpression

    • bookmarkLevel

      protected int bookmarkLevel
      The bookmark level for the anchor associated with this field.
      See Also:

  • Constructor Details

  • Method Details

    • getTextAdjust

      public TextAdjustEnum getTextAdjust()
      Description copied from interface: JRTextField
      Gets the text adjust type.
      Specified by:
      getTextAdjust in interface JRTextField
      Returns:
      a value representing one of the text adjust constants in TextAdjustEnum

    • setTextAdjust

      public void setTextAdjust(TextAdjustEnum textAdjust)
      Description copied from interface: JRTextField
      Sets the text adjust type.
      Specified by:
      setTextAdjust in interface JRTextField
      Parameters:
      textAdjust - a value representing one of the text adjust type constants in TextAdjustEnum

    • getEvaluationTime

      public EvaluationTimeEnum getEvaluationTime()
      Description copied from interface: JREvaluation
      Gets the evaluation time for this text field.
      Specified by:
      getEvaluationTime in interface JREvaluation
      Returns:
      one of the evaluation time constants in JRExpression

    • getPattern

      public String getPattern()
      Description copied from interface: JRTextField
      Gets the pattern used for this text field. The pattern will be used in a SimpleDateFormat for dates and a DecimalFormat for numeric text fields. The pattern format must follow one of these two classes formatting rules, as specified in the JDK API docs.
      Specified by:
      getPattern in interface JRTextField
      Returns:
      a string containing the pattern.

    • getOwnPattern

      public String getOwnPattern()
      Specified by:
      getOwnPattern in interface JRTextField

    • setPattern

      public void setPattern(String pattern)
      Description copied from interface: JRTextField
      Sets the pattern used for this text field. The pattern will be used in a SimpleDateFormat for dates and a DecimalFormat for numeric text fields. The pattern format must follow one of these two classes formatting rules, as specified in the JDK API docs. If the pattern is incorrect, the exception thrown by formatter classes will be rethrown by the JasperReports fill engine.
      Specified by:
      setPattern in interface JRTextField

    • isBlankWhenNull

      public boolean isBlankWhenNull()
      Description copied from interface: JRTextField
      Indicates whether an empty string will be displayed if the field's expression evaluates to null.
      Specified by:
      isBlankWhenNull in interface JRTextField
      Returns:
      true if an empty string will be displayed instead of null values, false otherwise

    • isOwnBlankWhenNull

      public Boolean isOwnBlankWhenNull()
      Specified by:
      isOwnBlankWhenNull in interface JRTextField

    • setBlankWhenNull

      public void setBlankWhenNull(Boolean isBlank)
      Description copied from interface: JRTextField
      Specifies whether an empty string should be displayed if the field's expression evaluates to null.
      Specified by:
      setBlankWhenNull in interface JRTextField
      Parameters:
      isBlank - true if an empty string will be displayed instead of null values, false otherwise

    • getHyperlinkType

      public HyperlinkTypeEnum getHyperlinkType()
      Description copied from interface: JRHyperlink
      Retrieves the hyperlink type for the element.

      The actual hyperlink type is determined by getLinkType(). This method can is used to determine whether the hyperlink type is one of the built-in types or a custom type. When hyperlink is of custom type, CUSTOM is returned.

      Specified by:
      getHyperlinkType in interface JRHyperlink
      Returns:
      one of the hyperlink type constants
      See Also:

    • getHyperlinkTarget

      public HyperlinkTargetEnum getHyperlinkTarget()
      Description copied from interface: JRHyperlink
      Retrieves the hyperlink target for the element.

      The actual hyperlink target is determined by getLinkTarget(). This method can is used to determine whether the hyperlink target is one of the built-in target names or a custom one. When hyperlink has a custom target name, HyperlinkTargetEnum.CUSTOM is returned.

      Specified by:
      getHyperlinkTarget in interface JRHyperlink
      Returns:
      one of the hyperlink target constants
      See Also:

    • getEvaluationGroup

      public String getEvaluationGroup()
      Description copied from interface: JREvaluation
      Gets the evaluation group for this text field. Used only when evaluation time is group.
      Specified by:
      getEvaluationGroup in interface JREvaluation
      See Also:

    • getExpression

      public JRExpression getExpression()
      Description copied from interface: JRTextField
      Gets the expression for this field. The result obtained after evaluating this expression will be dispayed as the field text.
      Specified by:
      getExpression in interface JRTextField

    • getPatternExpression

      public JRExpression getPatternExpression()
      Description copied from interface: JRTextField
      Gets the pattern expression, in case the patter needs to be dynamic.
      Specified by:
      getPatternExpression in interface JRTextField
      See Also:

    • getAnchorNameExpression

      public JRExpression getAnchorNameExpression()
      Description copied from interface: JRAnchor
      Returns an expression whose value represents the anchor name.
      Specified by:
      getAnchorNameExpression in interface JRAnchor

    • getBookmarkLevelExpression

      public JRExpression getBookmarkLevelExpression()
      Description copied from interface: JRAnchor
      Returns an expression whose value represents the bookmark level (starting from 1) corresponding to this anchor. When the expression is set and its value is not null, it will override the value of the bookmarkLevel attribute.
      Specified by:
      getBookmarkLevelExpression in interface JRAnchor

    • getHyperlinkReferenceExpression

      public JRExpression getHyperlinkReferenceExpression()
      Description copied from interface: JRHyperlink
      Returns the expression whose value represents the hyperlink reference. It is only used when the hyperlink type is reference or anchor
      Specified by:
      getHyperlinkReferenceExpression in interface JRHyperlink

    • getHyperlinkWhenExpression

      public JRExpression getHyperlinkWhenExpression()
      Description copied from interface: JRHyperlink
      Returns the expression that is evaluated in order to decide if the hyperlink should be displayed. This expression always returns a boolean value.
      Specified by:
      getHyperlinkWhenExpression in interface JRHyperlink

    • getHyperlinkAnchorExpression

      public JRExpression getHyperlinkAnchorExpression()
      Description copied from interface: JRHyperlink
      Returns the expression whose value represents the anchor. It is only used when the hyperlink type is anchor.
      Specified by:
      getHyperlinkAnchorExpression in interface JRHyperlink

    • getHyperlinkPageExpression

      public JRExpression getHyperlinkPageExpression()
      Description copied from interface: JRHyperlink
      Returns an integer representing the page index of the link. It is only used when the hyperlink type is page. If the expression does not evaluate to an integer, an exception will be thrown.
      Specified by:
      getHyperlinkPageExpression in interface JRHyperlink

    • collectExpressions

      public void collectExpressions(JRExpressionCollector collector)
      Specified by:
      collectExpressions in interface JRElement

    • visit

      public void visit(JRVisitor visitor)
      Specified by:
      visit in interface JRVisitable

    • getBookmarkLevel

      public int getBookmarkLevel()
      Description copied from interface: JRAnchor
      Returns the level of the bookmark corresponding to the anchor.
      Specified by:
      getBookmarkLevel in interface JRAnchor
      Returns:
      the level of the bookmark corresponding to the anchor (starting from 1) or NO_BOOKMARK if no bookmark should be created for this anchor

    • getLinkType

      public String getLinkType()
      Description copied from interface: JRHyperlink
      Returns the hyperlink type.

      The type can be one of the built-in types (Reference, LocalAnchor, LocalPage, RemoteAnchor, RemotePage), or can be an arbitrary type.

      Specified by:
      getLinkType in interface JRHyperlink
      Returns:
      the hyperlink type

    • getLinkTarget

      public String getLinkTarget()
      Description copied from interface: JRHyperlink
      Returns the hyperlink target name.

      The type can be one of the built-in names (Self, Blank, Top, Parent), or can be an arbitrary name.

      Specified by:
      getLinkTarget in interface JRHyperlink
      Returns:
      the hyperlink target name

    • getHyperlinkParameters

      public JRHyperlinkParameter[] getHyperlinkParameters()
      Description copied from interface: JRHyperlink
      Returns the list of hyperlink parameters.

      The parameters can be used by custom hyperlink types to generate dynamic links.

      Specified by:
      getHyperlinkParameters in interface JRHyperlink
      Returns:
      the list of hyperlink parameters

    • getHyperlinkTooltipExpression

      public JRExpression getHyperlinkTooltipExpression()
      Description copied from interface: JRHyperlink
      Returns the expression which will generate the hyperlink tooltip.
      Specified by:
      getHyperlinkTooltipExpression in interface JRHyperlink
      Returns:
      the expression which will generate the hyperlink tooltip

    • clone

      public Object clone()
      Specified by:
      clone in interface JRCloneable
      Overrides:
      clone in class JRBaseTextElement