IdxRichEditSubDocument.BeginUpdateCharacters(IdxRichEditDocumentRange) Method
In This Article
Starts to update character properties of the specified document range.
#Declaration
Delphi
function BeginUpdateCharacters(const ARange: IdxRichEditDocumentRange): IdxRichEditCharacterProperties; overload;
#Parameters
Name | Type | Description |
---|---|---|
ARange | Idx |
The target document range. |
#Returns
Type | Description |
---|---|
Idx |
The target document range’s character properties. |
#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 user 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