XRPictureBox Class

A Picture Box control that is used to display an image in a report.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v18.2.dll

Declaration

C#

[DefaultBindableProperty("ImageSource")]
public class XRPictureBox :
    XRControl,
    IEditOptionsContainer

VB.NET

<DefaultBindableProperty("ImageSource")>
Public Class XRPictureBox
    Inherits XRControl
    Implements IEditOptionsContainer

Remarks

The XRPictureBox control is used to display graphics from a BMP, JPG, JPEG, GIF, TIF, TIFF, PNG, ICO, DIB, RLE, JPE, JFIF, EMF, WMF or SVG file. This picture is specified either by the XRPictureBox.ImageSource or the XRPictureBox.ImageUrl property. The clipping and positioning of an image in the display area of the XRPictureBox is controlled by the XRPictureBox.Sizing property set to a ImageSizeMode enumeration value.

For more detailed information about the XRPictureBox control, see Picture Box.

Example

This example demonstrates how to create an XRPictureBox object, and set some of its properties.

C#

using System.Drawing;
using DevExpress.XtraPrinting;
using DevExpress.XtraReports.UI;
using DevExpress.XtraPrinting.Drawing;
// ...

public XRPictureBox CreateXRPictureBox()
{
    // Create an XRPictureBox object.
    XRPictureBox xrPictureBox = new XRPictureBox();

    // Set its image.
    xrPictureBox.ImageSource = new ImageSource(new Bitmap("C:\\test.bmp"));
    // Uncomment these lines to get images from a data source.
    // ExpressionBinding expressionBinding = new ExpressionBinding("BeforePrint", "ImageSource", "[Picture]");
    // xrPictureBox.ExpressionBindings.Add(expressionBinding);

    // Set its location.
    xrPictureBox.LocationF = new PointF(150F, 25F);

    // Set its size.
    xrPictureBox.SizeF = new SizeF(160F, 120F);

    // Set its size mode.
    xrPictureBox.Sizing = ImageSizeMode.AutoSize;

    return xrPictureBox;
}

VB.NET

Imports System.Drawing
Imports DevExpress.XtraPrinting
Imports DevExpress.XtraReports.UI
Imports DevExpress.XtraPrinting.Drawing
' ...

Public Function CreateXRPictureBox() As XRPictureBox
    ' Create an XRPictureBox object.
    Dim xrPictureBox As New XRPictureBox()

    ' Set its image.
    xrPictureBox.ImageSource = New ImageSource(New Bitmap("C:\test.bmp"))
    ' Uncomment these lines to get images from a data source.
    ' Dim expressionBinding As New ExpressionBinding("BeforePrint", "ImageSource", "[Picture]")
    ' xrPictureBox.ExpressionBindings.Add(expressionBinding)

    ' Set its location.
    xrPictureBox.LocationF = New PointF(150F, 25F)

    ' Set its size.
    xrPictureBox.SizeF = New SizeF(160F, 120F)

    ' Set its size mode.
    xrPictureBox.Sizing = ImageSizeMode.AutoSize

    Return xrPictureBox
End Function

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the XRPictureBox class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

Reporting_how-to-implement-a-custom-authorization-service-t488888/CS/AuthorizationService/Reports/CategoriesReport.cs#L21

private XRLabel xrLabel9;
private XRPictureBox xrPictureBox3;
private XRLine xrLine1;

VB.NET

Reporting_how-to-implement-a-custom-authorization-service-t488888/VB/AuthorizationService/Reports/CategoriesReport.vb#L23

Private xrLabel9 As XRLabel
Private xrPictureBox3 As XRPictureBox
Private xrLine1 As XRLine

Implements

IComponent

IDisposable

IEnumerable

IBrickOwner

IScriptable

DevExpress.Utils.Serializing.Helpers.IXtraSupportDeserializeCollectionItem

DevExpress.Utils.Serializing.IXtraSerializable

Inheritance

Object

MarshalByRefObject

Component

XRControl

XRPictureBox