officefileapi-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-subdocument-dot-endupdatecharacters-x28-devexpress-dot-xtrarichedit-dot-api-dot-native-dot-characterproperties-x29.md
Finalizes the modification of character formatting after calling the SubDocument.BeginUpdateCharacters method.
Namespace : DevExpress.XtraRichEdit.API.Native
Assembly : DevExpress.RichEdit.v25.2.Core.dll
NuGet Package : DevExpress.RichEdit.Core
void EndUpdateCharacters(
CharacterProperties properties
)
Sub EndUpdateCharacters(
properties As CharacterProperties
)
| Name | Type | Description |
|---|---|---|
| properties | CharacterProperties |
A CharacterProperties object containing character properties.
|
Document document = server.Document;
document.BeginUpdate();
document.AppendText("Normal\nFormatted\nNormal");
document.EndUpdate();
DocumentRange range = document.Paragraphs[1].Range;
CharacterProperties cp = document.BeginUpdateCharacters(range);
cp.FontName = "Comic Sans MS";
cp.FontSize = 18;
cp.ForeColor = Color.Blue;
cp.BackColor = Color.Snow;
cp.Underline = UnderlineType.DoubleWave;
cp.UnderlineColor = Color.Red;
document.EndUpdateCharacters(cp);
Dim document As Document = server.Document
document.BeginUpdate()
document.AppendText("Normal" & vbLf & "Formatted" & vbLf & "Normal")
document.EndUpdate()
Dim range As DocumentRange = document.Paragraphs(1).Range
Dim cp As CharacterProperties = document.BeginUpdateCharacters(range)
cp.FontName = "Comic Sans MS"
cp.FontSize = 18
cp.ForeColor = Color.Blue
cp.BackColor = Color.Snow
cp.Underline = UnderlineType.DoubleWave
cp.UnderlineColor = Color.Red
document.EndUpdateCharacters(cp)
The following code snippets (auto-collected from DevExpress Examples) contain references to the EndUpdateCharacters(CharacterProperties) 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.
winforms-richedit-document-api/CS/RichEditAPISample/CodeExamples/Formatting.cs#L31
// with this method call
document.EndUpdateCharacters(cp);
#endregion #FormatText
word-document-api-examples/CS/CodeExamples/FormattingActions.cs#L49
// Finalize to modify character formatting.
document.EndUpdateCharacters(cp);
#endregion #FormatText
wpf-richedit-document-api/CS/DXRichEditControlAPISample/CodeExamples/FormattingActions.cs#L23
cp.UnderlineColor = Color.Red;
document.EndUpdateCharacters(cp);
#endregion #FormatText
winforms-richedit-tables-simple-example/CS/TablesSimpleExample/Form1.cs#L132
properties.FontSize = 16;
document.EndUpdateCharacters(properties);
ParagraphProperties alignment = document.BeginUpdateParagraphs(table[0, 2].ContentRange);
word-document-api-table-examples/CS/Program.cs#L114
properties.FontSize = 16;
document.EndUpdateCharacters(properties);
ParagraphProperties alignment = document.BeginUpdateParagraphs(table[0, 1].ContentRange);
winforms-richedit-document-api/VB/RichEditAPISample/CodeExamples/Formatting.vb#L28
' with this method call
document.EndUpdateCharacters(cp)
#End Region ' #FormatText
word-document-api-examples/VB/CodeExamples/FormattingActions.vb#L42
' Finalize to modify character formatting.
document.EndUpdateCharacters(cp)
#End Region ' #FormatText
wpf-richedit-document-api/VB/DXRichEditControlAPISample/CodeExamples/FormattingActions.vb#L20
cp.UnderlineColor = Color.Red
document.EndUpdateCharacters(cp)
' #End Region ' #FormatText
winforms-richedit-tables-simple-example/VB/TablesSimpleExample/Form1.vb#L108
properties.FontSize = 16
document.EndUpdateCharacters(properties)
Dim alignment As ParagraphProperties = document.BeginUpdateParagraphs(table(0, 2).ContentRange)
word-document-api-table-examples/VB/Program.vb#L90
properties.FontSize = 16
document.EndUpdateCharacters(properties)
Dim alignment As ParagraphProperties = document.BeginUpdateParagraphs(table(0, 1).ContentRange)
See Also
BeginUpdateParagraphs(DocumentRange)