Paragraph and Tabs Dialogs

  • 3 minutes to read

The Paragraph dialog enables end-users to format paragraphs (change the alignment of text and spacing between lines, specify paragraph indents, etc.).

End-users can invoke this dialog using the Paragraph group's dialog box launcher on the Home ribbon tab. Refer to the Lesson 1 - Create a Simple Rich Text Editor for details on how to provide the Ribbon UI for the RichEditControl.

DXRichEdit_ShowParagraphDialog_Ribbon

The Paragraph dialog is also available from the context menu.

DXRichEdit_ParagraphDialog_ContextMenu

To invoke the Paragraph and Tabs dialogs you can use the ShowParagraphFormCommand and ShowTabsFormCommand commands.

The dialog consists of the following tabs:

Indents and Spacing

DXRichEdit_ParagraphDialog

Options under this tab allows end-users to change the text alignment, define spacing between lines and specify paragraph indents.

The following API allows you to specify the Indents and Spacing options in code:

API Description
ParagraphProperties.Alignment Gets or sets text alignment within a paragraph.
ParagraphProperties.OutlineLevel Gets or sets the paragraph's outline level
ParagraphProperties.RightToLeft Specifies the paragraph's text direction.
ParagraphProperties.LeftIndent Gets or sets the paragraph's left indent
ParagraphProperties.RightIndent Gets or sets paragraph's right indent
ParagraphProperties.FirstLineIndentType Gets or sets a value specifying whether and how the first line in a paragraph is indented.
ParagraphProperties.FirstLineIndent Gets or sets the paragraph's first line indent.
ParagraphProperties.SpacingBefore Gets or sets the spacing before the current paragraph.
ParagraphProperties.SpacingAfter Gets or sets the spacing after the current paragraph.
ParagraphProperties.LineSpacingType Gets or sets the spacing type between paragraph's lines.
ParagraphProperties.LineSpacing Gets or sets the line spacing value
ParagraphProperties.ContextualSpacing Gets or sets whether to suppress addition of additional space (contextual spacing) between paragraphs of the same style.

Line and Page Breaks

DXRichEdit_ParagraphDialog_Pagination

End-users can use this tab to specify pagination options. The table below lists API you can use to specify Line and Page Breaks options:

API Description
ParagraphProperties.WidowOrphanControl Gets or sets whether to apply control over the widow and orphan lines.
ParagraphProperties.KeepWithNext Gets or sets whether to put a break between the current paragraph and the next paragraph
ParagraphProperties.KeepLinesTogether Gets or sets whether to prevent all page breaks that interrupt a paragraph.
ParagraphProperties.PageBreakBefore Gets or sets whether to insert a page break before specified paragraph.

Tabs

From the Paragraph dialog, end-users can invoke the Tabs dialog allowing them to set the tab stops and their characteristics.

DXRichEdit_TabsDialog

To modify tab stops in a particular paragraph, use the ParagraphPropertiesWithTabs.BeginUpdateTabs and ParagraphPropertiesWithTabs.EndUpdateTabs paired methods .

TIP

Refer to the How to: Change Formatting of the Current Paragraph document to get an example on how to format paragraphs in code.