SubDocument.InsertSingleLineText(DocumentPosition, String) Method

Inserts a single line of text (text without line breaks) at the specified position.

Namespace: DevExpress.XtraRichEdit.API.Native

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

Declaration

C#

DocumentRange InsertSingleLineText(
    DocumentPosition pos,
    string text
)

VB.NET

Function InsertSingleLineText(
    pos As DocumentPosition,
    text As String
) As DocumentRange

Parameters

Name	Type	Description
pos	DocumentPosition	A DocumentPosition object specifying the position at which the text should be inserted.
text	String	A String value specifying the text to insert.

Returns

Type	Description
DocumentRange	A DocumentRange object representing the DocumentRange.Start and DocumentRange.End positions of the inserted text.

Remarks

The InsertSingleLineText method enables you to insert plain text which has no line breaks. Using this method instead of the more complex SubDocument.InsertText method, can enhance performance.

Note

Do not use the InsertSingleLineText method to insert text that contains line breaks.

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the InsertSingleLineText(DocumentPosition, String) 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#

table-api-creating-table-a-simple-example-e3242/CS/Walkthrough_Creating_Table/Form1.cs#L39

DocumentPosition pos = doc.Range.Start;
DocumentRange rng = doc.InsertSingleLineText(pos, "Directory Information from C:\\");

tables-simple-example-t472346/CS/TablesSimpleExample/Form1.cs#L98

//Insert the header data
document.InsertSingleLineText(table.Rows[0].Cells[1].Range.Start, "Active Customers");
document.InsertSingleLineText(table[2, 0].Range.Start, "Photo");

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

//Insert the header data
document.InsertSingleLineText(table.Rows[0].Cells[1].Range.Start, "Active Customers");
document.InsertSingleLineText(table[2, 0].Range.Start, "Photo");

dxrichedit-for-wpf-table-api-creating-table-a-simple-example-e3266/CS/MainWindow.xaml.cs#L142

TableCell cell = row.FirstCell;
doc.InsertSingleLineText(cell.Range.Start, fi.Name);
doc.InsertSingleLineText(cell.Next.Range.Start,

how-to-use-api-to-set-tab-stops-tab-leading-characters-and-the-tab-marker-e3081/CS/TabStops/Form1.cs#L48

cmd.Execute();
richEditControl1.Document.InsertSingleLineText(richEditControl1.Document.Selection.Start, "Amount");
cmd.Execute();

VB.NET

table-api-creating-table-a-simple-example-e3242/VB/Walkthrough_Creating_Table/Form1.vb#L36

Dim pos As DocumentPosition = doc.Range.Start
Dim rng As DocumentRange = doc.InsertSingleLineText(pos, "Directory Information from C:\")

tables-simple-example-t472346/VB/TablesSimpleExample/Form1.vb#L92

'Insert the header data
document.InsertSingleLineText(table.Rows(0).Cells(1).Range.Start, "Active Customers")
document.InsertSingleLineText(table(2, 0).Range.Start, "Photo")

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

'Insert the header data
document.InsertSingleLineText(table.Rows(0).Cells(1).Range.Start, "Active Customers")
document.InsertSingleLineText(table(2, 0).Range.Start, "Photo")

dxrichedit-for-wpf-table-api-creating-table-a-simple-example-e3266/VB/MainWindow.xaml.vb#L142

Dim cell As TableCell = row.FirstCell
doc.InsertSingleLineText(cell.Range.Start, fi.Name)
doc.InsertSingleLineText(cell.Next.Range.Start, String.Format("{0:N0}", fi.Length))

how-to-use-api-to-set-tab-stops-tab-leading-characters-and-the-tab-marker-e3081/VB/TabStops/Form1.vb#L46

cmd.Execute()
richEditControl1.Document.InsertSingleLineText(richEditControl1.Document.Selection.Start, "Amount")
cmd.Execute()