Picture
The Picture control in section reports is used to print an image on the report. This control supports Base64 string, Byte[], BMP, JPG/JPEG/JPE, GIF, PNG, EMF, WMF, SVG, TIF/TIFF formats in both GDI and CrossPlatform compatibility modes.
Important Properties
By clicking the Picture control, you can set its properties in the Properties panel.
Property | Description |
|---|---|
Image | Select any image file to display on your report. |
PictureAlignment | Gets or sets the position of the image within the control area. The possible values are Center (default), TopLeft, TopRight, BottomLeft, and BottomRight. |
SizeMode | Gets or sets a value that determines how the image is sized to fit the Picture control area. The possible values are Clip (default), Stretch, and Zoom. |
ApplyExifOrientation | Specifies whether to apply the orientation defined in the image’s EXIF metadata. The possible values are Auto (default), True, and False.
|
SVG Support
In CrossPlatform compatibility mode, SVG images are supported as vector images (original images) in all viewers and in PDF export; in other export formats, the images are exported as raster images. The GDI compatibility mode is recommended for use only as a fallback since SVG images are converted to raster images in all viewers and export formats.
Picture Dialog Properties
You can set the Picture properties in the Picture dialog. To open it, with the Picture selected on the report, under the Properties window, click the Property dialog link.
General
Name: Enter a name for the picture control that is unique within the report. This name is displayed in the Document Outline and in XML exports. You can only use underscore (_) as a special character in the Name field. Other special characters such as period (.), space ( ), forward slash (/), backslash (\), exclamation (!), and hyphen (-) are not supported.
Tag: Enter a string that you want to persist with the control. If you access this property in code, it is an object, but in the Properties window or Property dialog, it is a string.
Visible: Clear this check box to hide the control.
DataField: Select a field from the data source to bind to the control.
Choose image: Click this button to open a dialog where you can navigate to a folder from which to select an image file to display.
Hyperlink: Enter a URL to use in the Viewer HyperLink event. The URL automatically converts to an anchor tag or hyperlink in PDF and HTML exports.
Title: Gets or sets the title of the control. The entered text appears as a tag when an exported pdf file is opened in the Text Editor. The entered text also appears on hovering the control in an exported PDF File and is audible in the Read Out Loud mode of the Acrobat Reader DC.
Description: Enter text to describe the image for those who cannot see it. This is used in the HTML export for the "alt" attribute of the img tag.
Appearance
Line style: Select a line style to use for the borderline. You can set it to Transparent, Solid, Dash, Dot, DashDot, DashDotDot, or Double.
Line weight: Enter the width for the borderline.
Line color: Select a color to use for the borderline.
Background color: Select a color to use for the background of the picture control.
Picture alignment: Select how to align the image within the control. You can select from TopLeft, TopRight, Center, BottomLeft, or BottomRight.
Size mode: Select how to size the image within the control. You can select from Clip, Stretch, or Zoom. The Clip option uses the original image size and clips off any excess. The Stretch option fits the image to the size and shape of the control. The Zoom option fits the image into the control while maintaining the aspect ratio of the original image.