TileItem.ImageScaleMode Property

Gets or sets the way a TileItem's glyph is stretched within the item.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v20.1.dll

Declaration

[Browsable(false)]
[DefaultValue(TileItemImageScaleMode.Default)]
[DXCategory("Appearance")]
public TileItemImageScaleMode ImageScaleMode { get; set; }
<Browsable(False)>
<DefaultValue(TileItemImageScaleMode.Default)>
<DXCategory("Appearance")>
Public Property ImageScaleMode As TileItemImageScaleMode

Property Value

Type Default Description
TileItemImageScaleMode

Default

A TileItemImageScaleMode enumerator value that specifies the way a TileItem's glyph is stretched within the item.

Remarks

The TileItem.Image property specifies an image used as a tile's icon. The ImageScaleMode property value specifies the way an image is stretched inside its parent tile. The TileItem.ImageAlignment property sets the icon's alignment mode.

Icon appearance settings, provided via the ImageScaleMode and TileItem.ImageAlignment properties, affect both static tiles and tiles with frame animation. They also override corresponding TileControl.ItemImageAlignment and TileControl.ItemImageScaleMode property values that affect the entire TileControl.

Since a tile item can have multiple icons provided via the TileItem.Elements collection, the ImageScaleMode property affects an image in the first collection item only. For this reason, we recommend using the TileItemElement.ImageScaleMode property rather than the ImageScaleMode property to be able to customize all tile elements.

See Also