GridOptionsSelection.EnableAppearanceFocusedCell Property

Gets or sets whether the appearance settings for focused cell are enabled.

Namespace: DevExpress.XtraGrid.Views.Grid

Assembly: DevExpress.XtraGrid.v24.2.dll

Declaration

C#

[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool EnableAppearanceFocusedCell { get; set; }

VB.NET

<DefaultValue(True)>
<XtraSerializableProperty>
Public Overridable Property EnableAppearanceFocusedCell As Boolean

Property Value

Type	Default	Description
Boolean	true	true if the appearance settings for focused cell are enabled; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to EnableAppearanceFocusedCell
GridView	.OptionsSelection .EnableAppearanceFocusedCell

Remarks

The EnableAppearanceFocusedCell property specifies whether the appearance settings specified by the GridViewAppearances.FocusedCell property are in effect.

If the focused cell is a custom painted cell or its appearance settings are specified in the GridView.RowCellStyle event handler, setting the EnableAppearanceFocusedCell property has no effect.

Refer to the Appearance and Conditional Formatting document for more information on customizing the appearance settings of individual cells.

Example

This example customizes appearance settings of the focused cell:

C#

// 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.NET

' 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

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the EnableAppearanceFocusedCell 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.

C#

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

_GridView.OptionsSelection.MultiSelect = true;
_GridView.OptionsSelection.EnableAppearanceFocusedCell = false;
_GridView.FocusRectStyle = DrawFocusRectStyle.None;

winforms-grid-select-rows-with-mouse/CS/WindowsApplication1/Form1.cs#L24

    gridView1.OptionsBehavior.Editable = false;
    gridView1.OptionsSelection.EnableAppearanceFocusedCell = false;
}

VB.NET

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

_GridView.OptionsSelection.MultiSelect = True
_GridView.OptionsSelection.EnableAppearanceFocusedCell = False
_GridView.FocusRectStyle = DrawFocusRectStyle.None

winforms-grid-select-rows-with-mouse/VB/WindowsApplication1/Form1.vb#L20

    gridView1.OptionsBehavior.Editable = False
    gridView1.OptionsSelection.EnableAppearanceFocusedCell = False
End Sub