TileControl.ItemBackgroundImageScaleMode Property
Gets or sets the background images stretch mode common to TileItems within the current TileControl.
Namespace: DevExpress.XtraEditors
Assembly: DevExpress.XtraEditors.v24.1.dll
NuGet Package: DevExpress.Win.Navigation
Declaration
[DefaultValue(TileItemImageScaleMode.Default)]
[DXCategory("Appearance")]
public TileItemImageScaleMode ItemBackgroundImageScaleMode { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| TileItemImageScaleMode | Default | A TileItemImageScaleMode enumerator value that specifies the background images stretch mode for all TileItems within the current TileControl. |
Available values:
| Name | Description |
|---|---|
| Default | Acts as the TileItemImageScaleMode.NoScale value. |
| NoScale | An image is displayed in its original size and arranged according to the TileItem.ImageAlignment property. |
| Stretch | A glyph is stretched in order to fit within the area of a tile item. |
| StretchVertical | A glyph is stretched vertically. Its width remains unchanged. |
| StretchHorizontal | A glyph is stretched horizontally. Its height remains unchanged. |
| ZoomInside | Zooms an image proportionally so that it’s displayed within the client area in its entirety. |
| ZoomOutside | Zooms an image proportionally, allowing its smaller side (width or height) to be displayed in its entirety. The image is centered, so the larger side (height or width) will not be displayed in its entirety. |
| Squeeze | An image is displayed as is if its actual size is smaller than the size of the container. If the image size is larger than the container’s size, the image is shrunk proportionally to fit the container’s bounds. |
Remarks
A tile’s background image is specified via the TileItem.BackgroundImage property. The ItemBackgroundImageScaleMode property specifies the background image stretch mode common to all TileItems within the current tile control. Use the TileItem.BackgroundImageScaleMode property to override these default settings for individual tiles.
Besides the scale mode, you can also specify the background image alignment via the TileControl.ItemBackgroundImageAlignment property. See the Tile Item Structure topic to learn more.