Skip to main content

Image

  • Updated

BackPrevious Topic  Next TopicNext

Image

The properties of an image object are:

Property NameDescription
General
Display Name Specifies the display name of the object.

Data type: String

Instance Name Shows the instance name of the object. This property is read only.
Geometry
Height Specifies the height of the object, in inches. Enter a numeric value to change the height.

Data type: Float

WidthSpecifies the width of the object, in inches. Enter a numeric value to change the width.

Data type: Float

XSpecifies the horizontal coordinate of the top left corner of the object, relative to its parent container. This property is unavailable if the Position property is set to static. Enter a numeric value to change the position in inches.

Data type: Float

YSpecifies the vertical coordinate of the top left corner of the object, relative to its parent container. This property is unavailable if the Position property is set to static. Enter a numeric value to change the position in inches.

Data type: Float

Color
BackgroundSpecifies the background color of the object. Choose a color from the drop-down list or select Custom to define a color in the Color Picker dialog. You can also enter a hexadecimal RGB value (for example, 0xff0000) to specify a color.

Data type: String

Others
Export to CSV Specifies whether to include the object when exporting the report to CSV.

Data type: Boolean

Export to ExcelSpecifies whether to include the object when exporting the report to Excel.

Data type: Boolean

Export to HTMLSpecifies whether to include the object when exporting the report to HTML.

Data type: Boolean

Export to PDFSpecifies whether to include the object when exporting the report to PDF.

Data type: Boolean

Export to PostScriptSpecifies whether to include the object when exporting the report to PostScript.

Data type: Boolean

Export to Report ResultSpecifies whether to include the object in Web Report Studio or when the report is opened in Web Report Result.

Data type: Boolean

Export to RTFSpecifies whether to include the object when exporting the report to RTF.

Data type: Boolean

Export to Text Specifies whether to include the object when exporting the report to Text.

Data type: Boolean

Export to XML Specifies whether to include the object when exporting the report to XML.

Data type: Boolean

Horizontal AlignmentSpecifies the horizontal alignment of the image in the container. Choose an option from the drop-down list.

Data type: Enumeration

InvisibleSpecifies whether to show or hide the object. All formulas and calculations will still be performed if the property is set to true. You can also use a formula to control whether or not to show the object.

Data type: Boolean

PositionSpecifies the position of the object. Available when the object is directly contained in the report body or a tabular cell.
  • absolute - The object's position will be decided by its X and Y property values.
  • static - The object will be positioned at the default location in its container. If selected, the X, Y and other position-related properties will be hidden or disabled.

Data type: Enumeration

Vertical Alignment Specifies the vertical alignment of the image in the container. Choose an option from the drop-down list.

Data type: Enumeration

Image Property
Alternate TextSpecifies the text that will be displayed instead if the image cannot be displayed.

Data type: String

DisabledSpecifies whether to disable the actions on the image.

Data type: Boolean

Image NameSpecifies the file name of the image. The image can be one on your local file system or retrieved using a URL.

Data type: String

Maximum Scaling RatioSpecifies the maximum ratio up to which the image can be scaled.

Data type: Float

NameSpecifies the name of the image.

Data type: String

RotationSpecifies the angle at which to rotate the image, in degrees. The following is the meaning of different values:
  • 0 - No rotation.
  • positive value - Rotates the image clockwise.
  • negative value - Rotates the image anticlockwise.

Data type: Float

Scaling ModeSpecifies the scaling mode of the image, which controls the image behavior when you try to adjust the image field size. Choose an option from the drop-down list.
  • Actual Size - The image will remain its original size. If the image field size is smaller than the image size, part of the image will be cut off.
  • Fit Image - The image size will be automatically adjusted to fill up the image field, with its original perspective remained but under the limitation of Maximum Scaling Ratio.
  • Fit Width - The image will be automatically adjusted to fit the width of the image field but under the limitation of Maximum Scaling Ratio.
  • Fit Height - The image will be automatically adjusted to fit the height of the image field but under the limitation of Maximum Scaling Ratio.
  • Customize - The image size will be automatically adjusted to fit the image field, regardless of the Maximum Scaling Ratio's value.

Data type: Enumeration

TitleSpecifies the tip information about the image, which will be displayed when you hover the mouse pointer over the image in Web Report result.

Data type: String

BackPrevious Topic  Next TopicNext

Related articles