IdxRichEditSubDocument.EndUpdateCharacters(IdxRichEditCharacterProperties) Method
Applies the character property changes initiated by a BeginUpdateCharacters function call.
#Declaration
Delphi
procedure EndUpdateCharacters(const AProperties: IdxRichEditCharacterProperties);
#Parameters
Name | Type | Description |
---|---|---|
AProperties | Idx |
The character properties created by a Begin |
#Remarks
BeginUpdateCharacters and EndUpdateCharacters
are the key methods in the text editing API. A BeginUpdateCharacters method call obtains character properties of the target document range. The EndUpdateCharacters
procedure accepts these character settings and applies the changes made between BeginUpdateCharacters and EndUpdateCharacters
calls.
#Code Example: Apply Custom Formatting to Selected Text
The following code example applies the Bold font attribute to all selected document ranges and changes their font and background colors:
var
ADocument: IdxRichEditDocument;
ACharacterProperties: IdxRichEditCharacterProperties;
I: Integer;
begin
ADocument := dxRichEditControl1.Document;
ADocument.BeginUpdate; // Locks the document updates and starts recording an edit action
for I := 0 to ADocument.Selections.Count - 1 do // Iterates through all selected document ranges
begin
// Obtains character properties of the current selected document range
ACharacterProperties := ADocument.BeginUpdateCharacters(ADocument.Selections.Self[I]);
ACharacterProperties.BackColor := TdxAlphaColors.Blue;
ACharacterProperties.ForeColor := TdxAlphaColors.White;
ACharacterProperties.Bold := True;
ADocument.EndUpdateCharacters(ACharacterProperties); // Applies the changes to the range
end;
ADocument.EndUpdate; // Applies all pending changes to the document and unlocks document updates
end;
Note
Add the dxuses
clause to be able to use the Tdx
See Also