BeforeExportEventArgs.Options Property

Provides access to the exporter options.

Namespace: DevExpress.XtraRichEdit

Assembly: DevExpress.RichEdit.v19.1.Core.dll

Declaration

C#

public IExporterOptions Options { get; }

VB.NET

Public ReadOnly Property Options As IExporterOptions

Property Value

Type	Description
IExporterOptions	An IExporterOptions interface defining export options.

Remarks

The Options parameter can define different objects, exposing the IExporterOptions interface, dependant on the export format and the type of exporter. Apart from the IExporterOptions.TargetUri, it allows specifying different exporter-specific settings.

When exporting to HTML, you can specify several HTML export options, casting the Options value to the HtmlDocumentExporterOptions type. For example, to specify whether the style sheets should be saved in separate css files, or incorporated in the main document, use the HtmlDocumentExporterOptions.CssPropertiesExportType property.

The following code snippet illustrates this:

Note

A complete sample project is available at How to save the text of a document range in different formats.

C#

private void richEditControl_BeforeExport(object sender, DevExpress.XtraRichEdit.BeforeExportEventArgs e) {
    DevExpress.XtraRichEdit.Export.HtmlDocumentExporterOptions options = e.Options as DevExpress.XtraRichEdit.Export.HtmlDocumentExporterOptions;
    if (options != null) 
{
        options.CssPropertiesExportType = DevExpress.XtraRichEdit.Export.Html.CssPropertiesExportType.Link;
        options.HtmlNumberingListExportFormat = DevExpress.XtraRichEdit.Export.Html.HtmlNumberingListExportFormat.HtmlFormat;
        options.TargetUri = Path.GetFileNameWithoutExtension(this.fileName);
    }
}

VB.NET

Private Sub richEditControl_BeforeExport(ByVal sender As Object, ByVal e As DevExpress.XtraRichEdit.BeforeExportEventArgs)
    Dim options As DevExpress.XtraRichEdit.Export.HtmlDocumentExporterOptions = TryCast(e.Options, DevExpress.XtraRichEdit.Export.HtmlDocumentExporterOptions)
    If options IsNot Nothing Then
        options.CssPropertiesExportType = DevExpress.XtraRichEdit.Export.Html.CssPropertiesExportType.Link
        options.HtmlNumberingListExportFormat = DevExpress.XtraRichEdit.Export.Html.HtmlNumberingListExportFormat.HtmlFormat
        options.TargetUri = Path.GetFileNameWithoutExtension(Me.fileName)
    End If
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the Options property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

how-to-save-a-document-in-the-richedit-control-e1401/CS/SaveDocument/Form1.cs#L48

RtfDocumentExporterOptions options = e.Options as RtfDocumentExporterOptions;
if(options != null) {

dxrichedit-for-wpf-building-a-mail-application-with-the-richeditcontrol-e3276/CS/MainWindow.xaml.cs#L92

void OnBeforeExport(object sender, BeforeExportEventArgs e) {
    HtmlDocumentExporterOptions options = e.Options as HtmlDocumentExporterOptions;
    if (options != null) {

dxrichedit-for-wpf-how-to-save-the-text-of-a-document-range-in-different-formats-e3267/CS/MainWindow.xaml.cs#L88

private void richEditControl1_BeforeExport(object sender, BeforeExportEventArgs e) {
    HtmlDocumentExporterOptions options = e.Options as HtmlDocumentExporterOptions;
    if (options != null) {

building-a-mail-application-with-the-richeditcontrol-e2216/CS/RichEditSendMail/Form1.cs#L94

void OnBeforeExport(object sender, BeforeExportEventArgs e) {
    HtmlDocumentExporterOptions options = e.Options as HtmlDocumentExporterOptions;
    if (options != null) {

how-to-export-the-richeditcontrol-document-into-an-outlook-mail-item-e4438/CS/Form1.cs#L71

private void OnBeforeExport(object sender, BeforeExportEventArgs e) {
    HtmlDocumentExporterOptions options = e.Options as HtmlDocumentExporterOptions;
    if (options != null) {

VB.NET

how-to-save-a-document-in-the-richedit-control-e1401/VB/SaveDocument/Form1.vb#L43

Dim options As RtfDocumentExporterOptions = TryCast(e.Options, RtfDocumentExporterOptions)
If options IsNot Nothing Then

dxrichedit-for-wpf-building-a-mail-application-with-the-richeditcontrol-e3276/VB/MainWindow.xaml.vb#L94

Private Sub OnBeforeExport(ByVal sender As Object, ByVal e As BeforeExportEventArgs)
    Dim options As HtmlDocumentExporterOptions = TryCast(e.Options, HtmlDocumentExporterOptions)
    If options IsNot Nothing Then

dxrichedit-for-wpf-how-to-save-the-text-of-a-document-range-in-different-formats-e3267/VB/MainWindow.xaml.vb#L90

Private Sub richEditControl1_BeforeExport(ByVal sender As Object, ByVal e As BeforeExportEventArgs)
    Dim options As HtmlDocumentExporterOptions = TryCast(e.Options, HtmlDocumentExporterOptions)
    If options IsNot Nothing Then

building-a-mail-application-with-the-richeditcontrol-e2216/VB/RichEditSendMail/Form1.vb#L94

Private Sub OnBeforeExport(ByVal sender As Object, ByVal e As BeforeExportEventArgs)
    Dim options As HtmlDocumentExporterOptions = TryCast(e.Options, HtmlDocumentExporterOptions)
    If options IsNot Nothing Then

how-to-export-the-richeditcontrol-document-into-an-outlook-mail-item-e4438/VB/Form1.vb#L74

Private Sub OnBeforeExport(ByVal sender As Object, ByVal e As BeforeExportEventArgs)
    Dim options As HtmlDocumentExporterOptions = TryCast(e.Options, HtmlDocumentExporterOptions)
    If options IsNot Nothing Then