TableCollection.Create(DocumentPosition, Int32, Int32) Method
Inserts a blank table with the specified number of rows and columns at the specified position.
Namespace: DevExpress.XtraRichEdit.API.Native
Assembly: DevExpress.RichEdit.v24.2.Core.dll
NuGet Package: DevExpress.RichEdit.Core
#Declaration
Table Create(
DocumentPosition pos,
int rowCount,
int columnCount
)
#Parameters
Name | Type | Description |
---|---|---|
pos | Document |
A position at which a table is inserted. |
row |
Int32 | A number of table rows. |
column |
Int32 | A number of table columns. |
#Returns
Type | Description |
---|---|
Table | The created table. |
#Remarks
#Right-to-Left Direction in Tables
The inserted table’s text direction depends on the RightToLeft property value of a paragraph where the table should be inserted. If the paragraph’s RightToLeft property is set to true
, the table’s RightToLeft property is automatically set to true
. The RightToLeft property of all cell paragraphs is also set to true
.
Use the ReadOnlyParagraphCollection.Get(DocumentPosition) method to obtain the paragraph where the DocumentPosition is located.
#Successive Tables
When you call the 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. Successive tables with different directions are not merged.
Set the RichEditControlCompatibility.MergeSuccessiveTables property to false
to keep successive tables with the same direction separate.
#Example
The code sample below creates a table with three columns and four rows:
using DevExpress.XtraRichEdit;
using DevExpress.XtraRichEdit.API.Native;
using (var wordProcessor = new RichEditDocumentServer())
{
Document document = wordProcessor.Document;
// Create a new table
Table table = document.Tables.Create(document.Range.End, 2, 2);
// Add new rows to the table
table.Rows.InsertBefore(0);
table.Rows.InsertAfter(0);
// Add a new column to the table
table.Rows[0].Cells.Append()
}
#Related GitHub Examples
The following code snippets (auto-collected from DevExpress Examples) contain references to the Create(DocumentPosition, Int32, Int32) 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.