You can use the XRPictureBox control to embed static (stored with the report definition) or dynamic (obtained from a data source) images into a report. The images can have one of the following formats: BMP, JPG, JPEG, GIF, TIF, TIFF, PNG, ICO, DIB, RLE, JPE, JFIF, EMF, WMF, SVG.
To add the PictureBox control to a report, drag the XRPictureBox item from the DX:19.1: Report Controls Toolbox tab and drop it onto the report.
Specify the following properties to set an image:
- ImageSource
Use this property to save images along with a report definition.
- ImageUrl
Use this property to save only the path to the image.
Note
After the ImageUrl property is specified, the ImageSource property is set to null (Nothing in Visual Basic).
After the ImageSource property is specified, the ImageUrl property is set to Empty.
Bind a Picture Box to Data
Use one of the following techniques to add the XRPictureBox control that obtains an image from a data source.
-
Invoke the control's smart tag, expand the Expression drop-down list for the ImageSource property and select a data field.
You can bind the ImageUrl property to data in a similar way. In this instance, the URL that specifies the image location is obtained from the data source.
Click the Expression option's ellipsis button to invoke the Expression Editor. Use this editor to construct a binding expression that can include two or more data fields.
-
Drag an image data field from the report's Field List and drop it onto a report band.
-
Right-click a data field in the Field List and drop it onto a report band. Select the PictureBox item in the invoked context menu.
-
See the Bind Report Controls to Data topic for more information on the available data binding modes and how to create data-aware controls.
You can bind the XRPictureBox control to the following image types:
- Image (see System.Drawing.Image)
- DevExpress.Utils.Svg.SvgImage
- XML-formatted SVG
- Byte Array received from an SVG string or an Image (see System.Drawing.Image)
SVG Support Limitations
The XRPictureBox control does not support the following SVG content:
- Gradient colors
- Text (you can convert text to curves as a workaround)
- Animations
- External .css styles
Export (except for PDF) has the following limitations:
The Medium Trust permission level does not support SVG.
Image Size Modes
Set the Sizing property to one of the available image size modes to specify how to position an image within the control.
To display the image in the middle of the control, set the Sizing property to DevExpress.XtraPrinting.ImageSizeMode.Normal and the ImageAlignment property to DevExpress.XtraPrinting.ImageAlignment.MiddleCenter.
Interactivity
You can add a possibility to load/change an image and/or draw a signature in a picture box when it is displayed in Print Preview. To do this, set the EditOptions.Enabled property to true.
Click the picture box in a previewed document and an editor invokes.
Tip
You can draw borders (see XRControl.Borders) for the picture box to make the editor visible in Print Preview, if an image is not specified.
Refer to the Content Editing in Print Preview topic for details and to the Create an Interactive E-Form tutorial to see how the E-Form demo report uses this picture box mode.
Example
This example demonstrates how to create an XRPictureBox object and set its properties.
| C# |
using System.Drawing;
using DevExpress.XtraPrinting;
using DevExpress.XtraReports.UI;
using DevExpress.XtraPrinting.Drawing;
public XRPictureBox CreateXRPictureBox()
{
XRPictureBox xrPictureBox = new XRPictureBox();
xrPictureBox.ImageSource = new ImageSource(new Bitmap("C:\\test.bmp"));
xrPictureBox.LocationF = new PointF(150F, 25F);
xrPictureBox.SizeF = new SizeF(160F, 120F);
xrPictureBox.Sizing = ImageSizeMode.AutoSize;
return xrPictureBox;
}
|
| VB |
Imports System.Drawing
Imports DevExpress.XtraPrinting
Imports DevExpress.XtraReports.UI
Imports DevExpress.XtraPrinting.Drawing
Public Function CreateXRPictureBox() As XRPictureBox
Dim xrPictureBox As New XRPictureBox()
xrPictureBox.ImageSource = New ImageSource(New Bitmap("C:\test.bmp"))
xrPictureBox.LocationF = New PointF(150F, 25F)
xrPictureBox.SizeF = New SizeF(160F, 120F)
xrPictureBox.Sizing = ImageSizeMode.AutoSize
Return xrPictureBox
End Function
|
System.Object
System.MarshalByRefObject
System.ComponentModel.Component
XRControl
XRPictureBox