Back to Devexpress

IdxRichEditDocument.DocBytes Property

vcl-dxrichedit-dot-nativeapi-dot-idxricheditdocument-3d83e84f.md

latest5.7 KB
Original Source

IdxRichEditDocument.DocBytes Property

Specifies document content as a byte array (in the Microsoft Word® 97 – 2003 binary format).

Declaration

delphi
property DocBytes: TBytes read; write;

Property Value

TypeDescription
TBytes

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

|

Remarks

You can use the DocBytes property to import/export document content in the DOC format (ensure that support for the Microsoft Word® binary 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.

DocBytes property value read/write operations export/import document content. You can use the following properties to configure DOC export/import settings:

Options.Export.DocProvides access to settings applied to saving the current document to the Microsoft Word® 97 – 2003 binary document (DOC) file.Options.Import.DocProvides access to settings applied to importing Microsoft Word® 97 – 2003 binary documents (DOC files).

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:

OpenXmlBytesSpecifies document content as a byte array (in the Office OpenXML 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.DocBytes Property

Document Print and Import/Export

IdxRichEditDocument Interface

IdxRichEditDocument Members

dxRichEdit.NativeApi Unit