Back to Devexpress

IdxRichEditDocument.OpenXmlBytes Property

vcl-dxrichedit-dot-nativeapi-dot-idxricheditdocument-98502ae3.md

latest5.7 KB
Original Source

IdxRichEditDocument.OpenXmlBytes Property

Specifies document content as a byte array (in the Office OpenXML format).

Declaration

delphi
property OpenXmlBytes: TBytes read; write;

Property Value

TypeDescription
TBytes

Document content (as a byte array in the DOCX format).

|

Remarks

You can use the OpenXmlBytes property to import/export document content in the DOCX format (ensure that support for the Office OpenXML document format is enabled).

Internal Document Model and Import/Export Operations

Important

TdxRichEditControl and TdxRichEditDocumentServer components do not work natively with documents in the DOC format. Instead, these components build a document model in memory using an internal XML-like format. You can use the IdxRichEditDocument interface to edit the current document directly.

The OpenXmlBytes property value’s read/write operations import/export document content. You can use the following properties to configure DOCX import/export settings:

Options.Export.OpenXmlProvides access to settings applied to exporting a document to the DOCX file format.Options.Import.OpenXmlProvides access to settings applied to importing OpenXML (DOCX) documents into the Rich Edit control.

Import/Export Format Support

DevExpress Rich Text components initially support a limited number of document formats to avoid excessive dependencies:

TdxRichEditControlHas predefined support only for TXT and RTF.TdxRichEditDocumentServerHas predefined support only for TXT.

To enable support for all available formats, add all required dependencies at design time or in code:

ExtensionDocument FormatFormat ValueImport/Export SettingsSupport / Required Dependencies
TXT/txtPlain TextPlainTextOptions.Import.PlainText/Options.Export.PlainTextBuilt-in Support
RTF/rtfRich Text FormatRtfOptions.Import.Rtf/Options.Export.RtfdxRichEdit.Rtf (add only for TdxRichEditDocumentServer)
DOC/docMicrosoft Word® 97 – 2003DocOptions.Import.Doc/Options.Export.DocdxRichEdit.Doc
HTML/htmlHypertext Markup LanguageHtmlOptions.Import.Html/Options.Export.HtmldxRichEdit.Html
DOCX/docxOffice OpenXMLOpenXmlOptions.Import.OpenXml/Options.Export.OpenXmldxRichEdit.OpenXML

At design time, you can right-click a TdxRichEditControl or TdxRichEditDocumentServer component, expand the Add Unit to Support menu item, and add all required dependencies.

Other Document Import/Export Options

You can also use the following API members to import/export document content in different supported[1] formats:

DocBytesSpecifies document content as a byte array (in the Microsoft Word® 97 – 2003 binary format).RtfTextSpecifies document content (as an RTF string).TextSpecifies document content (as a plain text string).LoadDocument | SaveDocumentExport/import document content to/from a file or stream in any supported format.

Footnotes

  1. Ensure that support for all required document formats is enabled; otherwise, an exception occurs.
    Refer to corresponding API member descriptions for detailed information on support for different document formats.

See Also

TdxRichEditCustomDocumentServer.OpenXmlBytes Property

Document Print and Import/Export

IdxRichEditDocument Interface

IdxRichEditDocument Members

dxRichEdit.NativeApi Unit