Back to Devexpress

IdxRichEditDocument.SaveDocument(TStream,TdxRichEditDocumentFormat) Method

vcl-dxrichedit-dot-nativeapi-dot-idxricheditdocument-dot-savedocument-x28-system-dot-classes-dot-tstream-dxrichedit-dot-nativeapi-dot-tdxricheditdocumentformat-x29.md

latest5.6 KB
Original Source

IdxRichEditDocument.SaveDocument(TStream,TdxRichEditDocumentFormat) Method

Exports document content to a stream (in any supported format).

Declaration

delphi
procedure SaveDocument(AStream: TStream; AFormat: TdxRichEditDocumentFormat); overload;

Parameters

NameTypeDescription
AStreamTStream

The target stream.

| | AFormat | TdxRichEditDocumentFormat |

The target document format.

|

Remarks

Call the SaveDocument procedure to export the current document to a stream in any supported format.

Available Export Formats

The SaveDocument procedure accepts the required export format as the AFormat parameter. If you pass TdxRichEditDocumentFormat.Undefined as the parameter, the parent component’s Options.DocumentSaveOptions.DefaultFormat or Options.DocumentSaveOptions.CurrentFormat property defines the target document format.

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 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).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 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

TdxRichEditControlBase.SaveDocument Method

TdxRichEditCustomDocumentServer.SaveDocument Method

Document Print and Import/Export

IdxRichEditDocument Interface

IdxRichEditDocument Members

dxRichEdit.NativeApi Unit