[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
  [Collapse]Rich Text Editor
   [Expand]Product Information
    Product Class Structure
    Supported Formats
   [Expand]Getting Started
   [Expand]RichEditControl Document
    Text Formatting
    Import and Export
   [Expand]Page Layout
    Spell Checking
    AutoCorrect Feature
    Track Changes
    Mail Merge
    Restrictions and Protection
   [Collapse]Visual Elements
     Command UI
     Reviewing Pane
     Pop-up Menus
      Paste Special Dialog
      Font Dialog
      Paragraph and Tabs Dialogs
      Bullets and Numbering Dialog
      Find and Replace Dialog
      Symbol Dialog
      Bookmark Dialog
      Edit Hyperlink Dialog
      Page Setup Dialog
      Columns Dialog
      Line Numbers Dialog
      Hyphenation Dialog
      Insert Merge Field Dialog
      Document Protection Dialogs
      Editing Permissions Dialog
      Encrypt Document Dialog
      Table Layout Dialogs
      Table Style Dialog
      Table Properties Dialogs
      Borders and Shading Dialog
      Style Editor Dialog
      Shape Layout Dialog
      Document Properties Dialog
      Table of Contents Dialog
      Language Dialog
     End User Restrictions
    Keyboard Shortcuts
    HTML Tag Support
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Paragraph and Tabs Dialogs

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 How to: Create the RichEditControl with a Ribbon UI for details on how to provide the Ribbon UI for the RichEditControl.

The Paragraph dialog is also available from the context menu.

Execute the ShowParagraphFormCommand and ShowTabsFormCommand commands to invoke the Paragraph and Tabs dialogs.

The dialog consists of the following tabs:

Expanded Indents and Spacing

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
ParagraphPropertiesBase.Alignment Gets or sets the paragraph's text alignment.
ParagraphPropertiesBase.OutlineLevel Gets or sets the paragraph's outline level.
ParagraphPropertiesBase.RightToLeft Specifies the paragraph's text direction.
ParagraphPropertiesBase.LeftIndent Gets or sets a paragraph's left indent.
ParagraphPropertiesBase.RightIndent Gets or sets the paragraph's right indent.
ParagraphPropertiesBase.FirstLineIndentType Gets or sets a value specifying whether and how a paragraph's first line is indented.
ParagraphPropertiesBase.FirstLineIndent Gets or sets a value specifying the indent of the first line of a paragraph.
ParagraphPropertiesBase.SpacingBefore Gets or sets the spacing before the current paragraph.
ParagraphPropertiesBase.SpacingAfter Gets or sets the spacing after the current paragraph.
ParagraphPropertiesBase.LineSpacingType Gets or sets a value which determines the spacing between paragraph's lines.
ParagraphPropertiesBase.LineSpacing Gets or sets a line spacing value.
ParagraphPropertiesBase.ContextualSpacing Gets or sets whether to suppress addition of additional space (contextual spacing) between paragraphs of the same style.

Expanded Line and Page Breaks

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
ParagraphPropertiesBase.WidowOrphanControl Gets or sets whether to apply control over the widow and orphan lines.
ParagraphPropertiesBase.KeepWithNext Gets or sets whether to put a break between the current paragraph and the next paragraph.
ParagraphPropertiesBase.KeepLinesTogether Gets or sets whether to prevent all page breaks that interrupt a paragraph.
ParagraphPropertiesBase.PageBreakBefore Gets or sets whether to insert a page break before specified paragraph(s).
ParagraphPropertiesBase.SuppressLineNumbers Gets or sets whether to display line numbers for the paragraphs.
ParagraphPropertiesBase.SuppressHyphenation Gets or sets whether to hyphenate a paragraph.

Expanded Tabs

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

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


Refer to the How to: Change Formatting of the Current Paragraph document to get an example on how to modify paragraph formatting in code.

Handle the RichEditControl.ParagraphFormShowing or RichEditControl.TabsFormShowing event to customize the default Paragraph or Tabs dialog (modify captions, set default dialog values, implement custom validation, etc.) or substitute it with completely new dialog. Refer to the How to: Customize the Search Form or How to: Customize the Hyperlink Form document for an example.

Is this topic helpful?​​​​​​​