Class JRDesignImage

    • Field Detail

      • PROPERTY_ANCHOR_NAME_EXPRESSION

        public static final java.lang.String PROPERTY_ANCHOR_NAME_EXPRESSION
        See Also:
        Constant Field Values
      • PROPERTY_BOOKMARK_LEVEL

        public static final java.lang.String PROPERTY_BOOKMARK_LEVEL
        See Also:
        Constant Field Values
      • PROPERTY_BOOKMARK_LEVEL_EXPRESSION

        public static final java.lang.String PROPERTY_BOOKMARK_LEVEL_EXPRESSION
        See Also:
        Constant Field Values
      • PROPERTY_EVALUATION_GROUP

        public static final java.lang.String PROPERTY_EVALUATION_GROUP
        See Also:
        Constant Field Values
      • PROPERTY_EVALUATION_TIME

        public static final java.lang.String PROPERTY_EVALUATION_TIME
        See Also:
        Constant Field Values
      • PROPERTY_EXPRESSION

        public static final java.lang.String PROPERTY_EXPRESSION
        See Also:
        Constant Field Values
      • isUsingCache

        protected java.lang.Boolean isUsingCache
      • isLazy

        protected boolean isLazy
      • linkType

        protected java.lang.String linkType
      • linkTarget

        protected java.lang.String linkTarget
      • evaluationGroup

        protected JRGroup evaluationGroup
      • 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 image.
        See Also:
        JRAnchor.getBookmarkLevel()
    • Method Detail

      • getModeValue

        public ModeEnum getModeValue()
        Description copied from interface: JRCommonElement
        Returns the element transparency mode. The default value depends on the type of the report element. Graphic elements like rectangles and lines are opaque by default, but the images are transparent. Both static texts and text fields are transparent by default, and so are the subreport elements.
        Specified by:
        getModeValue in interface JRCommonElement
        Overrides:
        getModeValue in class JRBaseElement
      • getUsingCache

        public java.lang.Boolean getUsingCache()
        Description copied from interface: JRImage
        Indicates if the engine is loading the current image from cache. Implementations of this method return the actual value for the internal flag that was explicitly set on this image element.
        Specified by:
        getUsingCache in interface JRImage
        Returns:
        Boolean.TRUE if the image should be loaded from cache, Boolean.FALSE otherwise or null in case the flag was never explicitly set on this image element
      • getHyperlinkTypeValue

        public HyperlinkTypeEnum getHyperlinkTypeValue()
        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:
        getHyperlinkTypeValue in interface JRHyperlink
        Returns:
        one of the hyperlink type constants
        See Also:
        JRHyperlink.getLinkType()
      • 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
      • setUsingCache

        public void setUsingCache​(java.lang.Boolean isUsingCache)
        Description copied from interface: JRImage
        Specifies if the engine should be loading the current image from cache. If set to Boolean.TRUE, the reporting engine will try to recognize previously loaded images using their specified source. For example, it will recognize an image if the image source is a file name that it has already loaded, or if it is the same URL.

        If set to null, the engine will rely on some default value which depends on the type of the image expression. The cache is turned on by default only for images that have java.lang.String objects in their expressions.

        Specified by:
        setUsingCache in interface JRImage
      • isLazy

        public boolean isLazy()
        Description copied from interface: JRImage
        Indicates if the images will be loaded lazily or not.
        Specified by:
        isLazy in interface JRImage
      • setLazy

        public void setLazy​(boolean isLazy)
        Description copied from interface: JRImage
        Gives control over when the images are retrieved from their specified location. If set to true, the image is loaded from the specified location only when the document is viewed or exported to other formats. Otherwise it is loaded during the report filling process and stored in the resulting document.
        Specified by:
        setLazy in interface JRImage
        Parameters:
        isLazy - specifies whether
      • getOnErrorTypeValue

        public OnErrorTypeEnum getOnErrorTypeValue()
        Description copied from interface: JRImage
        Indicates how the engine will treat a missing image.
        Specified by:
        getOnErrorTypeValue in interface JRImage
        Returns:
        a value representing one of the missing image handling constants in OnErrorTypeEnum
      • setOnErrorType

        public void setOnErrorType​(OnErrorTypeEnum onErrorTypeValue)
        Description copied from interface: JRImage
        Specifies how the engine should treat a missing image.
        Specified by:
        setOnErrorType in interface JRImage
        Parameters:
        onErrorTypeValue - a value representing one of the missing image handling constants in OnErrorTypeEnum
      • setEvaluationTime

        public void setEvaluationTime​(EvaluationTimeEnum evaluationTimeValue)
        Sets the evaluation time for this image.
      • setHyperlinkType

        public void setHyperlinkType​(HyperlinkTypeEnum hyperlinkType)
        Sets the link type as a built-in hyperlink type.
        Parameters:
        hyperlinkType - the built-in hyperlink type
        See Also:
        getLinkType()
      • setEvaluationGroup

        public void setEvaluationGroup​(JRGroup evaluationGroup)
      • setExpression

        public void setExpression​(JRExpression expression)
      • setAnchorNameExpression

        public void setAnchorNameExpression​(JRExpression anchorNameExpression)
      • setBookmarkLevelExpression

        public void setBookmarkLevelExpression​(JRExpression bookmarkLevelExpression)
      • setHyperlinkReferenceExpression

        public void setHyperlinkReferenceExpression​(JRExpression hyperlinkReferenceExpression)
      • setHyperlinkWhenExpression

        public void setHyperlinkWhenExpression​(JRExpression hyperlinkWhenExpression)
      • setHyperlinkAnchorExpression

        public void setHyperlinkAnchorExpression​(JRExpression hyperlinkAnchorExpression)
      • setHyperlinkPageExpression

        public void setHyperlinkPageExpression​(JRExpression hyperlinkPageExpression)
      • 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
      • setBookmarkLevel

        public void setBookmarkLevel​(int bookmarkLevel)
        Sets the boomark level for the anchor associated with this image.
        Parameters:
        bookmarkLevel - the bookmark level (starting from 1) or NO_BOOKMARK if no bookmark should be created
      • getLinkType

        public java.lang.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 java.lang.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
      • setLinkType

        public void setLinkType​(java.lang.String type)
        Sets the hyperlink type.

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

        Parameters:
        type - the hyperlink type
      • setLinkTarget

        public void setLinkTarget​(java.lang.String target)
        Sets the hyperlink target name.

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

        Parameters:
        target - 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
      • getHyperlinkParametersList

        public java.util.List<JRHyperlinkParameter> getHyperlinkParametersList()
        Returns the list of custom hyperlink parameters.
        Returns:
        the list of custom hyperlink parameters
      • addHyperlinkParameter

        public void addHyperlinkParameter​(JRHyperlinkParameter parameter)
        Adds a custom hyperlink parameter.
        Parameters:
        parameter - the parameter to add
      • removeHyperlinkParameter

        public void removeHyperlinkParameter​(JRHyperlinkParameter parameter)
        Removes a custom hyperlink parameter.
        Parameters:
        parameter - the parameter to remove
      • removeHyperlinkParameter

        public void removeHyperlinkParameter​(java.lang.String parameterName)
        Removes a custom hyperlink parameter.

        If multiple parameters having the specified name exist, all of them will be removed

        Parameters:
        parameterName - the parameter name
      • 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
      • setHyperlinkTooltipExpression

        public void setHyperlinkTooltipExpression​(JRExpression hyperlinkTooltipExpression)
        Sets the expression which will be used to generate the hyperlink tooltip.
        Parameters:
        hyperlinkTooltipExpression - the expression which will be used to generate the hyperlink tooltip
        See Also:
        getHyperlinkTooltipExpression()