RepositoryItem.ReadOnly Property

Gets or sets a value specifying whether the editor’s value can be changed by end-users.

Namespace: DevExpress.XtraEditors.Repository

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

[DXCategory("Behavior")]
public virtual bool ReadOnly { get; set; }

VB.NET

<DXCategory("Behavior")>
Public Overridable Property [ReadOnly] As Boolean

Property Value

Type	Description
Boolean	true if end-users can not modify editor’s value; otherwise, false.

Remarks

Use this property to specify whether the editor’s value can be modified by an end-user.

Note: if the editor displays a text box, end-users are allowed to access the edit value. They can select the desired content’s portion and copy it to the Clipboard, for instance. If you need to prevent such actions, set the RepositoryItem.Enabled property to false.

Changing the ReadOnly property value raises the RepositoryItem.PropertiesChanged event.

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#

winforms-mvvm-best-practices/CS/DialogServices/XtraDialogServiceUserControl.cs#L22

memo.Dock = DockStyle.Top;
memo.Properties.ReadOnly = true;
memo.MinimumSize = new System.Drawing.Size(0, 100);

winforms-tokenedit-checked-tokens/CS/TokenEdit_Glyph_InEndOfToken/CustomTokenEdit/CustomTokenEditViewInfo.cs#L32

base.UpdateTokenState(tokenInfo);
if (!Item.ReadOnly)
{

XAF_treelisteditor-how-to-enable-in-place-editing-in-the-winforms-tree-list-view-e443/CS/WinSolution.Module.Win/TreeListInplaceEditViewController.cs#L54

foreach (RepositoryItem ri in treeList.RepositoryItems) {
    ri.ReadOnly = !treeListEditor.AllowEdit;
}

VB.NET

winforms-mvvm-best-practices/VB/DialogServices/XtraDialogServiceUserControl.vb#L22

memo.Dock = DockStyle.Top
memo.Properties.ReadOnly = True
memo.MinimumSize = New System.Drawing.Size(0, 100)

winforms-tokenedit-checked-tokens/VB/CustomTokenEdit/CustomTokenEditViewInfo.vb#L30

MyBase.UpdateTokenState(tokenInfo)
If Not Item.ReadOnly Then
    Dim pt As Point = If(OwnerControl IsNot Nothing, OwnerControl.PointToClient(Control.MousePosition), MousePosition)

XAF_treelisteditor-how-to-enable-in-place-editing-in-the-winforms-tree-list-view-e443/VB/WinSolution.Module.Win/TreeListInplaceEditViewController.vb#L56

For Each ri As RepositoryItem In treeList.RepositoryItems
    ri.ReadOnly = Not treeListEditor.AllowEdit
Next ri