Back to Devexpress

GridOptionsSelection.EnableAppearanceFocusedCell Property

windowsforms-devexpress-dot-xtragrid-dot-views-dot-grid-dot-gridoptionsselection.md

latest7.0 KB
Original Source

GridOptionsSelection.EnableAppearanceFocusedCell Property

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

Namespace : DevExpress.XtraGrid.Views.Grid

Assembly : DevExpress.XtraGrid.v25.2.dll

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

Declaration

csharp
[DefaultValue(true)]
[XtraSerializableProperty]
public virtual bool EnableAppearanceFocusedCell { get; set; }
vb
<DefaultValue(True)>
<XtraSerializableProperty>
Public Overridable Property EnableAppearanceFocusedCell As Boolean

Property Value

TypeDefaultDescription
Booleantrue

true if the appearance settings for focused cell are enabled; otherwise, false.

|

Property Paths

You can access this nested property as listed below:

Object TypePath 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:

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

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

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

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

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

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

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

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

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

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

vb
AddHandler gridView.EditFormShowing, AddressOf GridView_EditFormShowing
gridView.OptionsSelection.EnableAppearanceFocusedCell = False
gridView.FocusRectStyle = Views.Grid.DrawFocusRectStyle.RowFocus

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

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

See Also

EnableAppearanceFocusedRow

AppearanceCell

EnableAppearanceHideSelection

Appearance and Conditional Formatting

GridOptionsSelection Class

GridOptionsSelection Members

DevExpress.XtraGrid.Views.Grid Namespace