RichEditControl.EndUpdate() Method

Unlocks the RichEditControl object after a call to the RichEditControl.BeginUpdate method and causes an immediate visual update.

Namespace: DevExpress.XtraRichEdit

Assembly: DevExpress.XtraRichEdit.v20.2.dll

NuGet Package: DevExpress.Win.RichEdit

Declaration

C#

public void EndUpdate()

VB.NET

Public Sub

Remarks

Enclose your code in the RichEditControl.BeginUpdate - EndUpdate method calls to suppress the RichEditControl’s visual updates and improve its performance when you perform multiple changes to a document.

Each call to RichEditControl.BeginUpdate must be paired with the EndUpdate call. The RichEditControl.BeginUpdate method locks the RichEditControl, so that it is not rendered after each modification. The EndUpdate method unlocks the control to enable all the changes to take effect. You can use the try…finally statement to ensure that EndUpdate is always called even if an exception occurs.

The following example shows how to use the RichEditControl.BeginUpdate - EndUpdate methods.

C#

richEditControl1.BeginUpdate();
try
{
    Document document = richEditControl1.Document;

    // Create a multiplication table.
    Table table = document.Tables.Create(document.Selection.Start, 8, 8, AutoFitBehaviorType.AutoFitToWindow);

    table.Borders.InsideHorizontalBorder.LineThickness = 1;
    table.Borders.InsideHorizontalBorder.LineStyle = TableBorderLineStyle.Double;
    table.Borders.InsideVerticalBorder.LineThickness = 1;
    table.Borders.InsideVerticalBorder.LineStyle = TableBorderLineStyle.Double;
    table.TableAlignment = TableRowAlignment.Center;

    table.ForEachCell((cell, rowIndex, columnIndex) =>
    {
        document.InsertText(cell.Range.Start, String.Format("{0}*{1} = {2}",
             columnIndex + 2, rowIndex + 2, (rowIndex + 2) * (columnIndex + 2)));
    });

}
finally
{
    richEditControl1.EndUpdate();
}

VB.NET

richEditControl1.BeginUpdate()
Try
    Dim document As Document = richEditControl1.Document

    ' Create a multiplication table.
    Dim table As Table = document.Tables.Create(document.Selection.Start, 8, 8, AutoFitBehaviorType.AutoFitToWindow)

    table.Borders.InsideHorizontalBorder.LineThickness = 1
    table.Borders.InsideHorizontalBorder.LineStyle = TableBorderLineStyle.Double
    table.Borders.InsideVerticalBorder.LineThickness = 1
    table.Borders.InsideVerticalBorder.LineStyle = TableBorderLineStyle.Double
    table.TableAlignment = TableRowAlignment.Center

    table.ForEachCell(Sub(cell, rowIndex, columnIndex) document.InsertText(cell.Range.Start, String.Format("{0}*{1} = {2}", columnIndex + 2, rowIndex + 2, (rowIndex + 2) * (columnIndex + 2))))

Finally
    richEditControl1.EndUpdate()
End Try

Related GitHub Examples

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

how-the-layoutunit-property-affects-the-display-and-printout-appearance-e4021/CS/LayoutUnitExample/Form1.cs#L41

richEditControl1.EndUpdate();
richEditControl2.EndUpdate();

how-to-remove-an-empty-paragraph-when-appending-a-content-to-a-document-e4154/CS/Form1.cs#L19

    RemoveParFromSourceRtf();
    richEditControl1.EndUpdate();
}

how-to-use-different-printing-techniques-and-set-printing-options-in-code-e3882/CS/PrintingSystem/Form1.cs#L25

SetPrintOptions(richEditControl1);
richEditControl1.EndUpdate();
richEditControl1.Print();

how-to-replace-document-fields-with-their-values/CS/Form1.cs#L57

finally {
    control.EndUpdate();
}

richeditcontrol-event-viewer-t258534/CS/RichEditControlEventViewer/Form1.cs#L67

{
    richEditControl1.EndUpdate();
}

VB.NET

how-to-remove-an-empty-paragraph-when-appending-a-content-to-a-document-e4154/VB/Form1.vb#L21

    RemoveParFromSourceRtf()
    richEditControl1.EndUpdate()
End Sub

how-to-use-different-printing-techniques-and-set-printing-options-in-code-e3882/VB/PrintingSystem/Form1.vb#L23

SetPrintOptions(richEditControl1)
richEditControl1.EndUpdate()
richEditControl1.Print()

how-the-layoutunit-property-affects-the-display-and-printout-appearance-e4021/VB/LayoutUnitExample/Form1.vb#L51

richEditControl2.Document.AppendDocumentContent(richEditControl1.Document.Range)
richEditControl2.EndUpdate()

how-to-replace-document-fields-with-their-values/VB/Form1.vb#L54

Finally
    control.EndUpdate()
End Try

richeditcontrol-event-viewer-t258534/VB/RichEditControlEventViewer/Form1.vb#L59

Finally
    richEditControl1.EndUpdate()
End Try