Skip to main content
All docs
V24.1

SubDocument.GetFlatOpcTemplateBytes(DocumentRange, FlatOpcTemplateDocumentExporterOptions) Method

Exports the range content in FlatOpcTemplate (Microsoft Word XML Template, .xml) format and returns a byte array with this content.

Namespace: DevExpress.XtraRichEdit.API.Native

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

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

Declaration

byte[] GetFlatOpcTemplateBytes(
    DocumentRange range,
    FlatOpcTemplateDocumentExporterOptions options
)

Parameters

Name Type Description
range DocumentRange

The range to convert to FlatOpcTemplate format.

options FlatOpcTemplateDocumentExporterOptions

An object that contains export settings.

Returns

Type Description
Byte[]

The range content in FlatOpcTemplate format.

Remarks

If you work with a selection range, make sure that the GetFlatOpcTemplate method is enclosed with the DocumentRange.BeginUpdateDocument - DocumentRange.EndUpdateDocument method pair. Otherwise, an incorrect document model might be selected, and the “Error: specified document position or range belongs to other document or subdocument” exception is thrown.

To retrieve section settings, make sure that the range contains the last section’s paragraph. Otherwise, the section settings are reset to default.

The code sample below retrieves the range content in FlatOpcMacroEnabled format:

using (RichEditDocumentServer wordProcessor = new RichEditDocumentServer())
{
    wordProcessor.LoadDocument("FirstLook.docx");
    Document document = wordProcessor.Document;

    FlatOpcTemplateDocumentExporterOptions exportOptions = wordProcessor.Options.Export.FlatOpcTemplate;
    exportOptions.ExportedDocumentProperties = DocumentPropertyNames.None;

    byte[] bytes = document.GetFlatOpcTemplateBytes(document.Range, exportOptions);
    File.WriteAllBytes(@"D:\testdoc.xml", bytes);
}
See Also