Interface IImage
-
- All Superinterfaces:
IDesignElement
,IReportElement
,IReportItem
public interface IImage extends IReportItem
Represents a the design of an Image in the scripting environment
-
-
Field Summary
-
Fields inherited from interface org.eclipse.birt.report.model.api.simpleapi.IReportItem
constants
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description void
addAction(IAction action)
Add the action structure to this Image item.IAction
getAction()
Returns a handle to work with the action property, action is a structure that defines a hyperlink.java.lang.String
getAltText()
Returns the alternate text of this image.java.lang.String
getAltTextKey()
Returns the resource key of the alternate text of this image.java.lang.String
getFile()
Returns the image file, if the source type is notIMAGE_REF_TYPE_FILE
return null.java.lang.String
getHelpText()
Returns the help text of this image item.java.lang.String
getHelpTextKey()
Returns the resource key of the help text of this image item.java.lang.String
getImageName()
Returns the embedded image name that this image refers, if the image source type isIMAGE_REF_TYPE_EMBED
.double
getScale()
Returns the image scale.java.lang.String
getSize()
Returns the image size.java.lang.String
getSource()
Returns the image source type.java.lang.String
getTypeExpression()
Returns the type expression of the image item if the image source type isIMAGE_REF_TYPE_EXPR
.java.lang.String
getURI()
Returns the image URI if the image source type isIMAGE_REF_TYPE_URL
orIMAGE_REF_TYPE_FILE
.java.lang.String
getURL()
Gets the image url, if the source type is notIMAGE_REF_TYPE_URL
return null.java.lang.String
getValueExpression()
Returns the value expression of the image if the image source type isIMAGE_REF_TYPE_EXPR
.void
setAltText(java.lang.String altText)
Sets the alternate text of this image.void
setAltTextKey(java.lang.String altTextKey)
Sets the resource key of the alternate text of this image.void
setFile(java.lang.String file)
Sets the image file.void
setHelpText(java.lang.String helpText)
Sets the help text of this image item.void
setHelpTextKey(java.lang.String helpTextKey)
Sets the resource key of help text of this image item.void
setImageName(java.lang.String name)
Sets the embedded image name that this image refers, if the image source type isIMAGE_REF_TYPE_EMBED
.void
setScale(double scale)
Sets the image scale property.void
setSize(java.lang.String size)
Sets the image size property.void
setSource(java.lang.String source)
Returns the image source type.void
setTypeExpression(java.lang.String value)
Sets the type expression value.void
setURI(java.lang.String uri)
Deprecated.Sets the image uri property.void
setURL(java.lang.String url)
Sets the image url.void
setValueExpression(java.lang.String value)
Sets the value expression value.-
Methods inherited from interface org.eclipse.birt.report.model.api.simpleapi.IDesignElement
getNamedExpression, getParent, getQualifiedName, getReport, getStyle, getUserProperty, getUserPropertyExpression, setNamedExpression, setUserProperty, setUserProperty
-
Methods inherited from interface org.eclipse.birt.report.model.api.simpleapi.IReportElement
getComments, getCustomXml, getDisplayName, getDisplayNameKey, getName, setComments, setCustomXml, setDisplayName, setDisplayNameKey, setName
-
Methods inherited from interface org.eclipse.birt.report.model.api.simpleapi.IReportItem
addDataBinding, addHideRule, addHighlightRule, getBookmark, getDataBinding, getDataBindings, getHeight, getHideRules, getHighlightRules, getTocExpression, getWidth, getX, getY, removeDataBinding, removeDataBindings, removeHideRule, removeHideRules, removeHighlightRule, removeHighlightRules, setBookmark, setCurrentView, setHeight, setHeight, setTocExpression, setWidth, setWidth, setX, setX, setY, setY
-
-
-
-
Method Detail
-
getScale
double getScale()
Returns the image scale. The scale factor for the image given as a percentage.- Returns:
- the scale of this image.
-
getSize
java.lang.String getSize()
Returns the image size. The size must be the internal name that is one the following options defined inDesignChoiceConstants
:IMAGE_SIZE_SIZE_TO_IMAGE
IMAGE_SIZE_SCALE_TO_ITEM
IMAGE_SIZE_CLIP
- Returns:
- the internal value of the image size.
-
getAltText
java.lang.String getAltText()
Returns the alternate text of this image.- Returns:
- the alternate text of the image item.
-
setAltText
void setAltText(java.lang.String altText) throws SemanticException
Sets the alternate text of this image.- Parameters:
altText
- the alternate text of the image item.- Throws:
SemanticException
-
getAltTextKey
java.lang.String getAltTextKey()
Returns the resource key of the alternate text of this image.- Returns:
- the resource key of the alternate text
-
setAltTextKey
void setAltTextKey(java.lang.String altTextKey) throws SemanticException
Sets the resource key of the alternate text of this image.- Parameters:
altTextKey
- the alternate text of the image item.- Throws:
SemanticException
-
getSource
java.lang.String getSource()
Returns the image source type. This is one of the following options defined inDesignChoiceConstants
:IMAGE_REF_TYPE_NONE
IMAGE_REF_TYPE_URL
IMAGE_REF_TYPE_FILE
IMAGE_REF_TYPE_EXPR
IMAGE_REF_TYPE_EMBED
- Returns:
- the image source type.
-
setSource
void setSource(java.lang.String source) throws SemanticException
Returns the image source type. This is one of the following options defined inDesignChoiceConstants
:IMAGE_REF_TYPE_NONE
IMAGE_REF_TYPE_URL
IMAGE_REF_TYPE_FILE
IMAGE_REF_TYPE_EXPR
IMAGE_REF_TYPE_EMBED
- Parameters:
source
- the image source type.- Throws:
SemanticException
- if thesource
is not one of the above.
-
getURI
java.lang.String getURI()
Returns the image URI if the image source type isIMAGE_REF_TYPE_URL
orIMAGE_REF_TYPE_FILE
.- Returns:
- the image URI if the image source type is
IMAGE_REF_TYPE_URL
orIMAGE_REF_TYPE_FILE
. Otherwise, returnnull
.
-
getTypeExpression
java.lang.String getTypeExpression()
Returns the type expression of the image item if the image source type isIMAGE_REF_TYPE_EXPR
.- Returns:
- the type expression, if the image source type is
IMAGE_REF_TYPE_EXPR
. Otherwise, returnnull
.
-
getValueExpression
java.lang.String getValueExpression()
Returns the value expression of the image if the image source type isIMAGE_REF_TYPE_EXPR
.- Returns:
- the value expression, if the image source type is
IMAGE_REF_TYPE_EXPR
. Otherwise, returnnull
.
-
getImageName
java.lang.String getImageName()
Returns the embedded image name that this image refers, if the image source type isIMAGE_REF_TYPE_EMBED
. This is not the same asDesignElementHandle.getName()
of this image item.- Returns:
- the embedded image name, if the image source type is
IMAGE_REF_TYPE_EMBED
. Otherwise, returnnull
.
-
setImageName
void setImageName(java.lang.String name) throws SemanticException
Sets the embedded image name that this image refers, if the image source type isIMAGE_REF_TYPE_EMBED
. The reference type is automatically set in this method. This is not the same asDesignElementHandle.setName( String )
.- Parameters:
name
- the embedded image name- Throws:
SemanticException
- if the property is locked.
-
setURI
@Deprecated void setURI(java.lang.String uri) throws SemanticException
Deprecated.Sets the image uri property. The source type is automatically set in this method. WhetherIMAGE_REF_TYPE_FILE
orIMAGE_REF_TYPE_URL
depends on the uri to set.- Parameters:
uri
- the uri to be set.- Throws:
SemanticException
- if the property is locked.
-
setScale
void setScale(double scale) throws SemanticException
Sets the image scale property. The scale factor for the image given as a percentage. The default is 100%.- Parameters:
scale
- the scale value to be set.- Throws:
SemanticException
- if the property is locked.
-
setSize
void setSize(java.lang.String size) throws SemanticException
Sets the image size property. The input value is one of the followings defined inDesignChoiceConstants
:IMAGE_SIZE_SIZE_TO_IMAGE
IMAGE_SIZE_SCALE_TO_ITEM
IMAGE_SIZE_CLIP
- Parameters:
size
- the size value to be set.- Throws:
SemanticException
- if the input size is not one of the above, or if the property is locked.
-
setTypeExpression
void setTypeExpression(java.lang.String value) throws SemanticException
Sets the type expression value. The source type is automatically set toIMAGE_REF_TYPE_EXPR
.- Parameters:
value
- the type expression value.- Throws:
SemanticException
- if the property is locked.
-
setValueExpression
void setValueExpression(java.lang.String value) throws SemanticException
Sets the value expression value. The source type is automatically set toIMAGE_REF_TYPE_EXPR
.- Parameters:
value
- the value expression.- Throws:
SemanticException
- if the property is locked.
-
getAction
IAction getAction()
Returns a handle to work with the action property, action is a structure that defines a hyperlink.- Returns:
- a handle to the action property, return
null
if the action has not been set on the image. - See Also:
ActionHandle
-
addAction
void addAction(IAction action) throws SemanticException
Add the action structure to this Image item.- Parameters:
action
-- Throws:
SemanticException
-
getHelpText
java.lang.String getHelpText()
Returns the help text of this image item.- Returns:
- the help text
-
setHelpText
void setHelpText(java.lang.String helpText) throws SemanticException
Sets the help text of this image item.- Parameters:
helpText
- the help text- Throws:
SemanticException
- if the property is locked.
-
getHelpTextKey
java.lang.String getHelpTextKey()
Returns the resource key of the help text of this image item.- Returns:
- the resource key of the help text
-
setHelpTextKey
void setHelpTextKey(java.lang.String helpTextKey) throws SemanticException
Sets the resource key of help text of this image item.- Parameters:
helpTextKey
- the help text- Throws:
SemanticException
- if the property is locked.
-
setURL
void setURL(java.lang.String url) throws SemanticException
Sets the image url. The source type isIMAGE_REF_TYPE_URL
, and will automatically set in this method.- Parameters:
url
-- Throws:
SemanticException
-
getURL
java.lang.String getURL()
Gets the image url, if the source type is notIMAGE_REF_TYPE_URL
return null.- Returns:
- image url.
-
setFile
void setFile(java.lang.String file) throws SemanticException
Sets the image file. The source type isIMAGE_REF_TYPE_FILE
, and will automatically set in this method.- Parameters:
file
-- Throws:
SemanticException
-
getFile
java.lang.String getFile()
Returns the image file, if the source type is notIMAGE_REF_TYPE_FILE
return null.- Returns:
- image file.
-
-