Skip to main content

FieldOptions.UpdateLockedFields Property

Gets or sets whether locked fields can be updated.

Namespace: DevExpress.XtraRichEdit

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

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation

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