ActiveReports 18 .NET Edition
Report Authors: Designer Components / Report Controls / Section Report / Picture
In This Topic
    Picture
    In This Topic

    The Picture control in section reports is used to print an image on the report. In the Image property of the Picture control, you can select any image file to display on your report. You should use the PictureAlignment and SizeMode properties to control cropping and alignment.

    Picture control supports Base64 string, Byte[], BMP, JPG, JPEG, JPE, GIF, PNG, EMF, WMF, and SVG formats in both GDI and CrossPlatform compatibility modes.

    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. 

    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.

    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 - Clip uses the original image size and clips off any excess, Stretch fits the image to the size and shape of the control, and Zoom fits the image into the control while maintaining the aspect ratio of the original image.

    See Also