OptionsColumn.ReadOnly Property

Gets or sets whether end-users are prevented from editing the column’s cell values.

Namespace: DevExpress.XtraGrid.Columns

Assembly: DevExpress.XtraGrid.v19.1.dll

Declaration

C#

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

VB.NET

<DefaultValue(False)>
<XtraSerializableProperty>
Public Property ReadOnly As Boolean

Property Value

Type	Default	Description
Boolean	**false**	true if end-users are prevented from modifying the column’s cell values; otherwise, false.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ReadOnly
GridColumn	.OptionsColumn.ReadOnly
LayoutViewColumn	.OptionsColumn.ReadOnly
BandedGridColumn	.OptionsColumn.ReadOnly

Remarks

If the ReadOnly property is set to true, the cell values of columns cannot be modified by end-users. In this case cell editors can be invoked but end-users can only select and copy an editor’s content. This option is not in effect if the column’s OptionsColumn.AllowEdit or the View’s ColumnView.Editable option is disabled.

Cell values can still be modified in code using the ColumnView.SetRowCellValue method regardless of the ReadOnly property’s setting.

Related GitHub Examples

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

how-to-set-default-values-for-a-new-data-row-e840/CS/Form1.cs#L96

    gridControl1.DataSource = view;
    gridView1.Columns["ID"].OptionsColumn.ReadOnly = true;
}

how-to-display-enumeration-values-in-grid-cells-e402/CS/WindowsApplication274/Form1.cs#L31

gridView1.Columns["EnumValue"].ColumnEdit = item;
gridView1.Columns["EnumValue"].OptionsColumn.ReadOnly = true;
gridView1.Columns["EnumValue"].OptionsColumn.AllowEdit = false;

how-to-display-and-edit-complex-data-properties-in-grid-columns-e672/CS/Form1.cs#L44

    DevExpress.XtraGrid.Columns.GridColumn c = gridView.Columns["Address"];
    c.OptionsColumn.ReadOnly = true;
}

VB.NET

how-to-set-default-values-for-a-new-data-row-e840/VB/Form1.vb#L97

    gridControl1.DataSource = view
    gridView1.Columns("ID").OptionsColumn.ReadOnly = True
End Sub

how-to-display-enumeration-values-in-grid-cells-e402/VB/WindowsApplication274/Form1.vb#L29

gridView1.Columns("EnumValue").ColumnEdit = item
gridView1.Columns("EnumValue").OptionsColumn.ReadOnly = True
gridView1.Columns("EnumValue").OptionsColumn.AllowEdit = False

how-to-display-and-edit-complex-data-properties-in-grid-columns-e672/VB/Form1.vb#L43

    Dim c As DevExpress.XtraGrid.Columns.GridColumn = gridView.Columns("Address")
    c.OptionsColumn.ReadOnly = True
End Sub