Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

FieldOptions.UpdateLockedFields Property

Gets or sets whether locked fields can be updated.

Namespace: DevExpress.XtraRichEdit

Assembly: DevExpress.RichEdit.v24.2.Core.dll

NuGet Package: DevExpress.RichEdit.Core

#Declaration

[DefaultValue(UpdateLockedFields.Never)]
public UpdateLockedFields UpdateLockedFields { get; set; }

#Property Value

Type Default Description
UpdateLockedFields Never

An UpdateLockedFields enumeration member that specifies what fields can be updated.

Available values:

Name Description
Always

Locked fields are updated.

Never

Locked fields are not updated. Default value.

DocVariableOnly

Only DOCVARIABLE fields are updated.

#Property Paths

You can access this nested property as listed below:

Object Type Path to UpdateLockedFields
RichEditControlOptionsBase
.Fields .UpdateLockedFields

#Remarks

Use the Field.Locked property to lock/unlock a field. The UpdateLockedFields option allows you to temporarily disable field lock for all fields, or for DOCVARIABLE fields only.

#Example

The code sample below allows to update DOCVARIABLE fields and updates all field in the main document body.

View Example

richEditControl2.Options.Fields.UpdateLockedFields = UpdateLockedFields.DocVariableOnly;
richEditControl2.Document.Fields.Update();

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the UpdateLockedFields 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.

See Also