Back to Devexpress

GridView.FocusRectStyle Property

windowsforms-devexpress-dot-xtragrid-dot-views-dot-grid-dot-gridview-30abb610.md

latest5.7 KB
Original Source

GridView.FocusRectStyle Property

Gets or sets a value specifying how the focus rectangle is painted.

Namespace : DevExpress.XtraGrid.Views.Grid

Assembly : DevExpress.XtraGrid.v25.2.dll

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

Declaration

csharp
[DefaultValue(DrawFocusRectStyle.CellFocus)]
[DXCategory("Appearance")]
[XtraSerializableProperty]
public virtual DrawFocusRectStyle FocusRectStyle { get; set; }
vb
<DefaultValue(DrawFocusRectStyle.CellFocus)>
<XtraSerializableProperty>
<DXCategory("Appearance")>
Public Overridable Property FocusRectStyle As DrawFocusRectStyle

Property Value

TypeDefaultDescription
DrawFocusRectStyleCellFocus

A DrawFocusRectStyle enumerator value.

|

Available values:

NameDescription
None

The focus rectangle is not painted.

| | RowFocus |

The focus rectangle is painted around the focused row, excluding the preview section (if it’s visible).

| | CellFocus |

The focus rectangle is painted around the focused cell.

| | RowFullFocus |

The focus rectangle is painted around the focused row, encompassing the preview section (if it’s visible).

|

Example

This example customizes appearance settings of the focused cell:

csharp
// Make the grid read-only.
gridView1.OptionsBehavior.Editable = false;
// Prevent the focused cell from being highlighted.
gridView1.OptionsSelection.EnableAppearanceFocusedCell = false;
// Draw a dotted focus rectangle around the entire row.
gridView1.FocusRectStyle = DevExpress.XtraGrid.Views.Grid.DrawFocusRectStyle.RowFocus;
vb
' Make the grid read-only.
gridView1.OptionsBehavior.Editable = False
' Prevent the focused cell from being highlighted.
gridView1.OptionsSelection.EnableAppearanceFocusedCell = False
' Draw a dotted focus rectangle around the entire row.
gridView1.FocusRectStyle = DevExpress.XtraGrid.Views.Grid.DrawFocusRectStyle.RowFocus

The following code snippets (auto-collected from DevExpress Examples) contain references to the FocusRectStyle property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

winforms-grid-select-rows-using-mouse-without-ctrl/CS/MultiSelectionHelper.cs#L29

csharp
_GridView.OptionsSelection.EnableAppearanceFocusedCell = false;
    _GridView.FocusRectStyle = DrawFocusRectStyle.None;
}

connect-winforms-grid-to-backend-using-middletier-server/CS/WinForms.Client/MainForm.cs#L36

csharp
gridView.OptionsSelection.EnableAppearanceFocusedCell = false;
gridView.FocusRectStyle = DevExpress.XtraGrid.Views.Grid.DrawFocusRectStyle.RowFocus;

winforms-grid-select-rows-using-mouse-without-ctrl/VB/MultiSelectionHelper.vb#L24

vb
_GridView.OptionsSelection.EnableAppearanceFocusedCell = False
    _GridView.FocusRectStyle = DrawFocusRectStyle.None
End Sub

connect-winforms-grid-to-backend-using-middletier-server/VB/WinForms.Client/MainForm.vb#L27

vb
gridView.OptionsSelection.EnableAppearanceFocusedCell = False
gridView.FocusRectStyle = Views.Grid.DrawFocusRectStyle.RowFocus
bbiNew.Enabled = RemoteContextUtils.IsGranded(GetType(Employee), SecurityOperations.Create)

See Also

EnableAppearanceFocusedCell

Focus Data Grid Cells

Multiple Row and Cell Selection

GridView Class

GridView Members

DevExpress.XtraGrid.Views.Grid Namespace