How to: Change Formatting of the Current Paragraph
- 2 minutes to read
This code sample demonstrates how you can modify the attributes of the current paragraph. The Document.Selection property is used to obtain the DocumentRange object, representing the user selection.
To modify paragraph formatting, such as the ParagraphPropertiesBase.LineSpacing, ParagraphPropertiesBase.Alignment, ParagraphPropertiesBase.SpacingBefore etc., call the SubDocument.BeginUpdateParagraphs method for the specified range, modify the properties of the returned ParagraphProperties object and call the SubDocument.EndUpdateParagraphs method to finalize the modification.
The following code snippet changes the first line indent and the line spacing of the paragraph containing the selection.
Note
To change default paragraph formatting for the current document, use the Document.DefaultParagraphProperties property.
Note
A complete sample project is available at: WinForms RichEdit Document API
document.BeginUpdate();
document.AppendText("Modified Paragraph\nNormal\nNormal");
document.EndUpdate();
//The target range is the first paragraph
DocumentPosition pos = document.Range.Start;
DocumentRange range = document.CreateRange(pos, 0);
// Create and customize an object
// that sets character formatting for the selected range
ParagraphProperties pp = document.BeginUpdateParagraphs(range);
// Center paragraph
pp.Alignment = ParagraphAlignment.Center;
// Set triple spacing
pp.LineSpacingType = ParagraphLineSpacing.Multiple;
pp.LineSpacingMultiplier = 3;
// Set left indent at 0.5".
// Default unit is 1/300 of an inch (a document unit).
pp.LeftIndent = DevExpress.Office.Utils.Units.InchesToDocumentsF(0.5f);
// Set tab stop at 1.5"
TabInfoCollection tbiColl = pp.BeginUpdateTabs(true);
TabInfo tbi = new DevExpress.XtraRichEdit.API.Native.TabInfo();
tbi.Alignment = TabAlignmentType.Center;
tbi.Position = DevExpress.Office.Utils.Units.InchesToDocumentsF(1.5f);
tbiColl.Add(tbi);
pp.EndUpdateTabs(tbiColl);
//Finalize modifications
// with this method call
document.EndUpdateParagraphs(pp);