Skip to main content

SubDocument.GetText(DocumentRange, PlainTextDocumentExporterOptions, TextFragmentOptions) Method

Returns the plain text of the specified document range.

Namespace: DevExpress.XtraRichEdit.API.Native

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

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

Declaration

string GetText(
    DocumentRange range,
    PlainTextDocumentExporterOptions options,
    TextFragmentOptions getTextOptions
)

Parameters

Name Type Description
range DocumentRange

A DocumentRange object, specifying the range in the document for which the plain text representation is obtained.

options PlainTextDocumentExporterOptions

A PlainTextDocumentExporterOptions instance, containing options for plain text export.

getTextOptions TextFragmentOptions

A TextFragmentOptions object.

Returns

Type Description
String

A String value, containing the text of the specified range.

Remarks

Use this method to get a plain text representation of any part of the document. This method overload triggers export-related events as described in the following table:

Event Description
RichEditControl.BeforeExport Does not occur.
RichEditControl.AfterExport Does not occur.

Note

If you operate with a selection range, the GetText method should be combined with a DocumentRange.BeginUpdateDocument - DocumentRange.EndUpdateDocument method pair. Otherwise, an incorrect document model might be selected, resulting in an exception “Error: specified document position or range belongs to other document or subdocument” being thrown.

For an example of use, refer to another SubDocument.GetText method overloads.

See Also