Table.MergeCells(TableCell, TableCell) Method

Merges the cells in the specified range into a single cell.

Namespace: DevExpress.XtraRichEdit.API.Native

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

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation

Declaration

C#

void MergeCells(
    TableCell mergeFrom,
    TableCell mergeTo
)

VB.NET

Sub MergeCells(
    mergeFrom As TableCell,
    mergeTo As TableCell
)

Parameters

Name	Type	Description
mergeFrom	TableCell	A TableCell that marks one end of the merged range.
mergeTo	TableCell	A TableCell that marks the opposite end of the merged range.

Remarks

All cells that fall within a table range marked by specified cells (including them) are merged into a single cell. The order in which cells are specified as method arguments does not matter.

Example

This code snippet performs the following:

• creates a table containing 6 rows and 8 columns
• merges cells horizontally in the third row from the third to the sixth column
• merges cells vertically in the third column from the fourth to the eighth row

View Example

TablesActions.cs

Document document = server.Document;
Table table = document.Tables.Create(document.Range.Start, 6, 8);
table.BeginUpdate();
table.MergeCells(table[2, 1], table[5, 1]);
table.MergeCells(table[2, 3], table[2, 7]);
table.EndUpdate();

TablesActions.vb

Dim document As Document = server.Document
Dim table As Table = document.Tables.Create(document.Range.Start, 6, 8)
table.BeginUpdate()
table.MergeCells(table(2, 1), table(5, 1))
table.MergeCells(table(2, 3), table(2, 7))
table.EndUpdate()

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the MergeCells(TableCell, TableCell) method.

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#

winforms-richedit-tables-simple-example/CS/TablesSimpleExample/Form1.cs#L57

// Merge cells
table.MergeCells(table[4, 2], table[4, 3]);
table.MergeCells(table[6, 2], table[6, 3]);

word-document-api-examples/CS/CodeExamples/TablesActions.cs#L101

// Merge table cells.
table.MergeCells(table[1, 1], table[2, 1]);

wpf-richedit-document-api/CS/DXRichEditControlAPISample/CodeExamples/TableActions.cs#L232

table.BeginUpdate();
table.MergeCells(table[2, 1], table[5, 1]);
table.MergeCells(table[2, 3], table[2, 7]);

word-document-api-table-examples/CS/TablesSimpleExample/Program.cs#L71

//Merge cells
table.MergeCells(table[4, 1], table[4, 2]);
table.MergeCells(table[6, 1], table[6, 2]);

winforms-richedit-document-api/CS/RichEditAPISample/CodeExamples/Table.cs#L228

table.BeginUpdate();
table.MergeCells(table[2, 1], table[5, 1]);
table.MergeCells(table[2, 3], table[2, 7]);

VB.NET

word-document-api-examples/VB/CodeExamples/TablesActions.vb#L92

            ' Merge table cells.
            table.MergeCells(table(1, 1), table(2, 1))
#End Region  ' #CreateFixedTable

wpf-richedit-document-api/VB/DXRichEditControlAPISample/CodeExamples/TableActions.vb#L205

table.BeginUpdate()
table.MergeCells(table(2, 1), table(5, 1))
table.MergeCells(table(2, 3), table(2, 7))

word-document-api-table-examples/VB/TablesSimpleExample/Program.vb#L58

'Merge cells
table.MergeCells(table(4, 1), table(4, 2))
table.MergeCells(table(6, 1), table(6, 2))

winforms-richedit-tables-simple-example/VB/TablesSimpleExample/Form1.vb#L72

'Merge cells
table.MergeCells(table(4, 1), table(4, 2))
table.MergeCells(table(6, 1), table(6, 2))

winforms-richedit-document-api/VB/RichEditAPISample/CodeExamples/Table.vb#L203

table.BeginUpdate()
table.MergeCells(table(2, 1), table(5, 1))
table.MergeCells(table(2, 3), table(2, 7))