Skip to main content

TdxRichEditCustomDocumentServer.LoadDocument(TStream) Method

Imports a document from a stream (in any supported format).

Declaration

function LoadDocument(AStream: TStream): Boolean; overload;

Parameters

Name Type Description
AStream TStream

The source stream.

Returns

Type Description
Boolean

True if the source document is loaded successfully; otherwise, False.

Remarks

Call the LoadDocument function to import a document from a stream in any supported format. Imported content replaces the current document.

A successful LoadDocument call updates Options.DocumentSaveOptions.CurrentFileName and Options.DocumentSaveOptions.CurrentFormat property values and raises the OnDocumentLoaded event.

The OnDocumentClosing event occurs immediately before a document import operation if the current document contains unsaved changes.

Source Document Format Detection

The LoadDocument function iterates through all supported formats to identify the best possible match for the source document.

Import Format Support

Support for all document formats, except for plain text, is initially disabled for the TdxRichEditDocumentServer component to avoid excessive dependencies. To enable support for available formats, add all required dependencies at design time or in code:

Extension Document Format Format Value Import/Export Settings Support / Required Dependencies
TXT/txt Plain Text PlainText Options.Import.PlainText/Options.Export.PlainText Built-in Support
RTF/rtf Rich Text Format Rtf Options.Import.Rtf/Options.Export.Rtf dxRichEdit.Rtf
DOC/doc Microsoft Word® 97 – 2003 Doc Options.Import.Doc/Options.Export.Doc dxRichEdit.Doc
HTML/html Hypertext Markup Language Html Options.Import.Html/Options.Export.Html dxRichEdit.Html
DOCX/docx Office OpenXML OpenXml Options.Import.OpenXml/Options.Export.OpenXml dxRichEdit.OpenXML

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

VCL Rich Edit Control: Add Supported Document Formats at Design Time

Other Document Import/Export Options

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

DocBytes
Specifies document content as a byte array (in the Microsoft Word® 97 – 2003 binary format).
HtmlText
Specifies document content as a string (in the HTML format).
OpenXmlBytes
Specifies document content as a byte array (in the Office OpenXML format).
RtfText
Specifies document content (as an RTF string).
Text
Specifies document content (as a plain text string).
LoadDocument | LoadDocumentTemplate | SaveDocument
Export/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