A newer version of this page is available. Switch to the current version.

ImageSizeMode Enum

Specifies how an image is positioned within a Picture Box.

Namespace: DevExpress.XtraPrinting

Assembly: DevExpress.Data.v18.2.dll

Declaration

[TypeConverter(typeof(EnumTypeConverter))]
[ResourceFinder(typeof(ResFinder))]
public enum ImageSizeMode
<TypeConverter(GetType(EnumTypeConverter))>
<ResourceFinder(GetType(ResFinder))>
Public Enum ImageSizeMode

Members

Name Description
Normal

ImageSizeMode-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

ImageSizeMode-StretchImage

The image is stretched or shrunk to fit into the current Picture Box dimensions.

AutoSize

ImageSizeMode-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

ImageSizeMode-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

ImageSizeMode-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

ImageSizeMode-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.

Related API Members

The following properties accept/return ImageSizeMode values:

Library Related API Members
Cross-Platform Class Library ImageBrick.SizeMode
ImageEditingField.ImageSizeMode
WinForms Controls SnapImage.ImageSizeMode
ASP.NET Controls and MVC Extensions ExportBinaryImageSettings.SizeMode
Reporting XRPictureBox.Sizing

Remarks

An ImageSizeMode object is returned by the XRPictureBox.Sizing property.

See Also