XRPictureBox.Sizing Property

Specifies the image displaying mode in the Picture Box control.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.XtraReports.v19.1.dll

NuGet Packages: DevExpress.Reporting.Core, DevExpress.WindowsDesktop.Core

Declaration

C#

[DefaultValue(ImageSizeMode.Normal)]
[SRCategory(ReportStringId.CatBehavior)]
public ImageSizeMode Sizing { get; set; }

VB.NET

<SRCategory(ReportStringId.CatBehavior)>
<DefaultValue(ImageSizeMode.Normal)>
Public Property Sizing As ImageSizeMode

Property Value

Type	Default	Description
ImageSizeMode	**Normal**	One of the ImageSizeMode enumeration values that specifies how the image is displayed in the control.

Available values:

Name	Description
Normal	The image is placed in the upper-left corner of the Picture Box. The image is clipped if it does not fit into the control’s bounds.
StretchImage	The image is stretched or shrunk to fit into the current Picture Box dimensions.
AutoSize	The Picture Box size is adjusted to that of the image it contains.
CenterImage	This option is obsolete. To achieve the same result, set the XRPictureBox.Sizing property of a Picture Box to ImageSizeMode.Normal and the XRPictureBox.ImageAlignment property to ImageAlignment.MiddleCenter.
ZoomImage	The image is sized proportionally (without clipping), so that it fits best within the Picture Box dimensions. If the height-to-width ratio of the control and the image are equal, the image will be resized to exactly fit into the control’s dimensions. Otherwise, the closest matching image side (height or width) will be sized to the control, and the other side will be sized proportionally (possibly leaving empty space within the control).
Squeeze	If the Picture Box dimensions exceed that of the image it contains, the image is centered and shown full-size. Otherwise, the image is resized to fit into the control’s dimensions.
Tile	The image is replicated within the Picture Box starting from the upper-left corner. The image is clipped if it does not fit into the control’s dimensions.

Remarks

Use this property to specify how the image should be displayed within the XRPictureBox control.

Illustration	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.ZoomImage The image is proportionally resized, so that it fits the control.
	ImageSizeMode.Squeeze If the control’s dimensions exceed the image size, the image is centered and shown full-size. Otherwise, the image is resized to fit into the control’s dimensions.
	ImageSizeMode.Tile The original image is replicated within the picture control starting from the upper-left corner. The replicated image is clipped if it does not fit in the picture control which contains it.

To display the image in the middle of the control, set the XRPictureBox.Sizing property to ImageSizeMode.Normal and the XRPictureBox.ImageAlignment property to ImageAlignment.MiddleCenter.

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()
{
    // 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