RichEditControlCompatibility.MergeSuccessiveTables Property

Specifies whether to merge the inserted table with the successive table.

Namespace: DevExpress.XtraRichEdit

Assembly: DevExpress.RichEdit.v24.2.Core.dll

NuGet Package: DevExpress.RichEdit.Core

Declaration

C#

[DefaultValue(true)]
public static bool MergeSuccessiveTables { get; set; }

VB.NET

<DefaultValue(True)>
Public Shared Property MergeSuccessiveTables As Boolean

Property Value

Type	Default	Description
Boolean	true	true, to merge successive tables; otherwise, false.

Remarks

When you call the TableCollection.Create method to insert a new table right before of after the existing table, these tables are merged, and the Create method returns the resulting table.

Set this property to false to keep successive tables separate.

The images below show how the tables are displayed depending on the MergeSuccessiveTables property value. The code sample below shows how these tables are inserted:

C#

private void CreateTable(Document document)
{
    document.Tables.Create(document.Range.Start,2,3,AutoFitBehaviorType.AutoFitToWindow);
    document.Tables.Create(document.Tables[0].Range.End, 2, 2, AutoFitBehaviorType.AutoFitToContents);
}

VB.NET

Private Sub CreateTable(ByVal document As Document)
    document.Tables.Create(document.Range.Start, 2, 3, AutoFitBehaviorType.AutoFitToWindow)
    document.Tables.Create(document.Tables(0).Range.[End], 2, 2, AutoFitBehaviorType.AutoFitToContents)
End Sub

• MergeSuccessiveTables = true

  

• MergeSuccessiveTables = false

  

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the MergeSuccessiveTables 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.

VB.NET

snap-convert-snx-to-repx/VB/SnxToRepx/Converter/SnapReportConverter.vb#L61

'Set this property to ensure that subsequent tables are not merged
DevExpress.XtraRichEdit.RichEditControlCompatibility.MergeSuccessiveTables = False
Try