ImageBrick.SizeMode Property
Specifies the size mode for the ImageBrick.
Namespace: DevExpress.XtraPrinting
Assembly: DevExpress.Printing.v18.2.Core.dll
Declaration
[XtraSerializableProperty]
[DefaultValue(ImageSizeMode.StretchImage)]
public ImageSizeMode SizeMode { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| ImageSizeMode | **StretchImage** | An ImageSizeMode enumeration value. |
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. |
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the SizeMode property.
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.