Skip to main content

TileItemElement.ImageScaleMode Property

Gets or sets the way a glyph is stretched within the current TileItemElement.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[Browsable(false)]
[DefaultValue(TileItemImageScaleMode.Default)]
[DXCategory("Appearance")]
public TileItemImageScaleMode ImageScaleMode { get; set; }

Property Value

Type Default Description
TileItemImageScaleMode Default

A TileItemImageScaleMode enumerator value that specifies the way a glyph is stretched within the current TileItemElement.

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 TileItemElement can have text content (specified via the TileItemElement.Text property) and a glyph (see the TileItemElement.Image). The ImageScaleMode property value specifies the way a glyph is stretched inside its parent element. The TileItemElement.ImageAlignment property sets this icon’s alignment mode.

This property has a higher priority than the TileControl.ItemImageScaleMode property that specifies a common stretch mode for all TileItems within a tile control.

A tile item can use multiple elements to build its content. If so, to customize the glyph of the first element within the TileItem.Elements collection, you can either use the ImageScaleMode or the TileItem.ImageScaleMode property.

See Also