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.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.2.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