Skip to main content

TileViewItemOptions.StretchItems Property

Gets or sets whether tiles are stretched to fit the View’s width/height (depending on the Orientation setting). The property is ignored in List layout mode.

Namespace: DevExpress.XtraGrid.Views.Tile

Assembly: DevExpress.XtraGrid.v24.1.dll

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

Declaration

[DefaultValue(false)]
[XtraSerializableProperty]
public bool StretchItems { get; set; }

Property Value

Type Default Description
Boolean false

true, to stretch the width/height of tiles so they fit the View’s width/height; false, if the width/height of tiles is not affected by the View’s width/height.

Property Paths

You can access this nested property as listed below:

Object Type Path to StretchItems
TileView
.OptionsTiles .StretchItems

Remarks

If the StretchItems property is set to false, tile display size is specified by the TileView.OptionsTiles.ItemSize property.

Set the StretchItems property to true to enable tile width/height stretching (depending on the Orientation setting).

Note

The StretchItems property has no effect in List layout mode, in which tiles are always stretched to fit the View’s width/height.

Tiles arranged in columns (Orientation=Vertical)

In stretch mode, the Tile View displays the specified number of tile columns (TileView.OptionsTiles.ColumnCount) while stretching them to the View’s width.
The following images demonstrate tile stretching for tiles arranged in two columns (TileView.OptionsTiles.ColumnCount = 2).

image

The TileView.OptionsTiles.ItemSize.Width value is ignored. Only the TileView.OptionsTiles.ItemSize.Height value is taken into account.

Tiles arranged in rows (Orientation=Horizontal)

In horizontal orienation mode, the Tile View displays the specified number of tile rows (TileViewItemOptions.RowCount) while stretching them to the View’s height. The following images demonstrate stretched tiles arranged in two rows (TileView.OptionsTiles.RowCount = 2).

image

The TileView.OptionsTiles.ItemSize.Height value is ignored. Only the TileView.OptionsTiles.ItemSize.Width value is taken into account.

See Also