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

ITileContainerDefaultProperties.ItemImageScaleMode Property

Gets or sets the common stretch mode for all Tiles' glyphs within the current TileContainer.

Namespace: DevExpress.XtraBars.Docking2010.Views.WindowsUI

Assembly: DevExpress.XtraBars.v19.2.dll


TileItemImageScaleMode? ItemImageScaleMode { get; set; }

Property Value

Type Description

A TileItemImageScaleMode enumerator value that specifies the common stretch mode for all Tiles' glyphs within the current TileContainer.

Available values:

Name Description

Acts as the TileItemImageScaleMode.NoScale value.


An image is displayed in its original size and arranged according to the TileItem.ImageAlignment property.


A glyph is stretched in order to fit within the area of a tile item.


A glyph is stretched vertically. Its width remains unchanged.


A glyph is stretched horizontally. Its height remains unchanged.


Zooms an image proportionally so that it's displayed within the client area in its entirety.


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.


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.


The ItemImageScaleMode property affects all images assigned to the TileItemElement.Image properties of the elements stored within the BaseTile.Elements collections for all the current TileContainer's Tiles. You can also specify an alignment common to all Tiles within a container via the ITileContainerDefaultProperties.ItemImageAlignment property.

See Also