Home > Report Designer > Report Controls > Report Elements > Picture Box

Picture Box

This document explains the basics of using the XRPictureBox control and describes its main features.

This document consists of the following sections.

• Picture Box Overview
• Image Size Modes

XRPictureBox is used to embed static (stored along with the report definition) or dynamic (obtained from a data source) images into a report.

It can display images of various file formats: BMP, JPG, JPEG, GIF, TIF, TIFF, PNG, ICO, DIB, RLE, JPE, JFIF, EMF, WMF.

To add this control to the report, drag the XRPictureBox item from the DX:11.2: Report Controls Toolbox tab and drop it onto the report.

Then, specify the image or image source for the control via the XRPictureBox.Image or the XRPictureBox.ImageUrl property.

The main difference between these two properties is that static images are serialized along with the report definitions, while for dynamic images, only the information about their source is stored in the report.

When the value of the ImageUrl property is set, the value of the Image property is set to null (Nothing in Visual Basic) and vice versa.

To quickly create XRPictureBox that is bound to a data field, right-click the corresponding node of the Field List and drop it onto a report band. In the invoked context menu, simply choose the PictureBox item.

To specify how an image is positioned within the control, set the XRPictureBox.Sizing property to one of the available image size modes.

Illustration	Size Mode	Description
	ImageSizeMode.Normal	The image is displayed with its original dimensions.
	ImageSizeMode.StretchImage	The image is stretched to fill both the control's width and height.
	ImageSizeMode.AutoSize	The control's dimensions are auto-adjusted to the image size.
	ImageSizeMode.CenterImage	The image is displayed in the middle of the control. If the image is larger than the control, the image is clipped.
	ImageSizeMode.ZoomImage	The image is proportionally re-sized, so that it fits the control.

See also