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

DocumentRangeExtensions.GetAsFrozen(IEnumerable<DocumentRange>) Method

Makes multiple DocumentRange objects uneditable.

Namespace: DevExpress.XtraRichEdit.API.Native

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

NuGet Package: DevExpress.RichEdit.Core

#Declaration

public static IEnumerable<DocumentRange> GetAsFrozen(
    this IEnumerable<DocumentRange> ranges
)

#Parameters

Name Type Description
ranges IEnumerable<DocumentRange>

The list of target document ranges.

#Returns

Type Description
IEnumerable<DocumentRange>

The list of frozen document ranges.

#Remarks

Use the GetAsFrozen method to improve performance when it is necessary to retrieve information from many document ranges, i.e., syntax highlighting.

After this method is called, RichEditControl or RichEditDocumentServer stops tracking the actual document position for these ranges.

Important

After the DocumentRange.GetAsFrozen method is executed, the target ranges cannot be modified. The frozen document ranges become invalid after the document is modified. Don’t use these ranges for further document processing operations.

See Also