Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TileViewItemOptions.ItemBackgroundImageScaleMode Property

Gets or sets the scale mode for tile background images.

Namespace: DevExpress.XtraGrid.Views.Tile

Assembly: DevExpress.XtraGrid.v24.2.dll

NuGet Packages: DevExpress.Win.Grid, DevExpress.Win.Navigation

#Declaration

[DefaultValue(TileItemImageScaleMode.Default)]
[XtraSerializableProperty]
public TileItemImageScaleMode ItemBackgroundImageScaleMode { get; set; }

#Property Value

Type Default Description
TileItemImageScaleMode Default

A TileItemImageScaleMode enumerator value that specifies the scale mode for tile background images.

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.

#Property Paths

You can access this nested property as listed below:

Object Type Path to ItemBackgroundImageScaleMode
TileView
.OptionsTiles .ItemBackgroundImageScaleMode

#Remarks

TileView tiles receive their background images from a grid column assigned to the BackgroundImages property, accessed through the TileView.ColumnSet properties section. See the Tile View topic to learn more.

See Also