ActiveReports 16 .NET Edition
ActiveReports 16 User Guide / Concepts / Section Report Concepts / Section Report Toolbox / Picture
In This Topic
    In This Topic

    In section reports, the Picture control 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.

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

    Note: Use the PictureAlignment and SizeMode properties to control cropping and alignment.

    Important Properties

    Property Description
    LineColor Gets or sets the border line color around the Picture control.
    LineStyle Gets or sets the pen style used to paint the border around the Picture control.
    LineWeight Gets or sets the pen width of the border line.
    PictureAlignment Gets or sets the position of the image within the control area.
    Description Gets or sets the alternate description for the picture. Used in the Html Export for the "alt" img tag property.
    HyperLink Gets or sets a URL address that can be used in the viewer's Hyperlink event to navigate to the specified location. The URL is automatically converted into an anchor tag or a hyperlink in HTML and PDF exports.
    Image Gets or sets the image to print.
    SizeMode Gets or sets a value that determines how the image is sized to fit the Picture control area.

    Picture Dialog

    With the control selected on the report, in the Commands section at the bottom of the Properties window, you can click the Property dialog command to open the dialog.


    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 (/), back slash (\), 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 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 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 border line. You can set it to Transparent, Solid, Dash, Dot, DashDot, DashDotDot, or Double.

    Line weight: Enter the width for the border line.

    Line color: Select a color to use for the border line.

    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