TdxRichEditCustomDocumentServer.LoadDocumentTemplate(string,TdxRichEditDocumentFormat) Method

Imports a document (as a template) from a file (in any supported format).

Declaration

procedure LoadDocumentTemplate(const AFileName: string; ADocumentFormat: TdxRichEditDocumentFormat); overload;

Parameters

An absolute or relative path to a source document file.

| | ADocumentFormat | TdxRichEditDocumentFormat |

The source document format.

|

Remarks

Call the LoadDocumentTemplate procedure to import a document from a file in any supported format. Imported content replaces the current document.

Related Properties and Events

The TdxRichEditDocumentServer component treats the imported document as a template (restores default values for Options.DocumentSaveOptions.CurrentFileName and Options.DocumentSaveOptions.CurrentFormat properties). A successful document import operation 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

Use the ADocumentFormat parameter to specify the source document format.

If you pass TdxRichEditDocumentFormat.Undefined as the ADocumentFormat parameter, the LoadDocumentTemplate procedure uses the source file name extension to identify the target format. If the file name has no extension, LoadDocumentTemplate iterates through all supported formats to find 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:

At design time, you can right-click the 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).HtmlTextSpecifies document content as a string (in the HTML 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 | LoadDocumentTemplate | 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

IdxRichEditDocument.LoadDocument Method

TdxRichEditControlBase.LoadDocument Method

Document Print and Import/Export

TdxRichEditCustomDocumentServer Class

TdxRichEditCustomDocumentServer Members

dxRichEdit.DocumentServer Unit