RichEditControl.LoadDocument(IWin32Window) Method

SECURITY NOTE

Downloading documents passed into the LoadDocument method may create security issues. Review the following help topic and learn how to spot, analyze, and prohibit unwanted download requests:

Suppress Control Requests to Download Data from External URLs

Invokes the Open file dialog as a child of the specified parent window.

Namespace: DevExpress.XtraRichEdit

Assembly: DevExpress.XtraRichEdit.v23.2.dll

NuGet Packages: DevExpress.Win.PivotGrid, DevExpress.Win.RichEdit, DevExpress.Win.TreeMap

Declaration

C#

public virtual void LoadDocument(
    IWin32Window parent
)

VB.NET

Public Overridable Sub LoadDocument(
    parent As IWin32Window
)

Parameters

Name	Type	Description
parent	IWin32Window	The IWin32Window object that is the parent window.

Remarks

File extension determines the document format. The following file extensions are recognized:

• DOC, DOCX, RTF, TXT, HTM, HTML, MHT, XML, EPUB;
• ODT - non-encrypted files only.

If the file is in a different format than its extension indicates, or encrypted, it is not loaded. However, you can subscribe to the RichEditControl.InvalidFormatException event which occurs in this situation and examine the RichEditInvalidFormatExceptionEventArgs.Exception property to find out a reason for not loading a document.

Tip

Determine a moment when the document model can be safely modified using the RichEditControl.DocumentLoaded event. Handle the DocumentLayout.DocumentFormatted event to check the loaded document’s layout.