Skip to main content
A newer version of this page is available.

TileViewItemOptions.HighlightFocusedTileOnGridLoad Property

Gets or sets whether the initially focused tile should be highlighted when the GridControl is loaded for the first time.

Namespace: DevExpress.XtraGrid.Views.Tile

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

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

Property Value

Type Default Description
Boolean **false**

true, if the initially focused tile should be highlighted; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type Path to HighlightFocusedTileOnGridLoad
TileView
.OptionsTiles.HighlightFocusedTileOnGridLoad

Remarks

When the grid control is loaded, by default, its first item is already focused (you can change the initially focused tile by setting the ColumnView.FocusedRowHandle property). This means an end-user can press the Space or Enter keys to raise the TileView.ItemClick event for the focused item or use arrow keys to navigate between tiles. However, by default, the initially focused tile is not highlighted with the selection border for best visual results. You can turn this selection on by setting the HighlightFocusedTileOnGridLoad property to true.

To specify whether the focused tile is highlighted using a border, background, both or is not highlighted, use the TileViewItemOptions.HighlightFocusedTileStyle property. To change the color of the selection border, use the TileView.FocusBorderColor property.

See Also