Rulers

  • 2 minutes to read

RichEditControl displays horizontal and vertical rulers. The horizontal ruler controls the table columns' width and the horizontal spacing of paragraph margins and tabs. The vertical ruler allows you to set the top and bottom margins of the document, and change the table rows' height.

DXRichEdit_HorizontalRuler

Horizontal and vertical rulers' visibility depends on the selected document view. End users can control the rulers' visibility using the Show toolbar or Ribbon page group.

DXRichEdit_Ribbon_Show

You can specify whether to hide or display rulers using the RichEditControl.VerticalRulerVisibility and RichEditControl.HorizontalRulerVisibility property, as shown below.

<dxre:RichEditControl>
   <dxre:RichEditControl.HorizontalRulerOptions>
            <dxre:DXRichEditHorizontalRulerOptions Visibility="Hidden"/>
  </dxre:RichEditControl.HorizontalRulerOptions>
     <dxre:RichEditControl.VerticalRulerOptions>
            <dxre:DXRichEditVerticalRulerOptions Visibility="Hidden"/>
  </dxre:RichEditControl.VerticalRulerOptions>
</dxre:RichEditControl>

The table below lists actions you can perform with horizontal and vertical rulers.

Functionality

Action

API

Adjust Page Margins (available only in the Page Layout view)

Position the cursor on the ruler at the current margin so it transforms into the double-headed horizontal arrow. Drag it to increase or decrease the margin.

The SectionMargins.Left

SectionMargins.Right

SectionMargins.Top

SectionMargins.Bottom

Use notation:

richEditControl1.Document.Sections[0].Margins.Left,

richEditControl1.Document.Sections[0].Margins.Right,

richEditControl1.Document.Sections[0].Margins.Top,

richEditControl1.Document.Sections[0].Margins.Bottom

Adjust Paragraph Margins

Drag the First Line Indent, Left Indent or the Right Indent markers.

The Paragraph.FirstLineIndent, Paragraph.LeftIndent or the Paragraph.RightIndent properties.

Set Tabs

Click the Tab Alignment Selector to toggle the tab alignment to the desired type. After that, click within the ruler to set the tab stop.

The TabInfo.Alignment and TabInfo.Position properties.

Adjust Column Width

Position the cursor on the ruler at the text boundaries, so that it transforms into the double-headed horizontal arrow. Drag it to adjust the column width.

The SectionColumn.Width and SectionColumn.Spacing properties.

Adjust Table Column Width

When the caret is in the table, position the cursor on the ruler at the column boundaries, so that it transforms into the double-headed horizontal arrow. Drag it to adjust the column width.

Tables

Adjust Table Row Height

Position the cursor on the ruler at the text boundaries, so that it transforms into the double-headed vertical arrow. Drag it to adjust the row height.

TableRow.Height

The ruler shows the DocumentUnit.Document (1/300 of an inch) measurement units. Specify the control's measurement unit using the RichEditControl.Unit property to change the ruler measurement. When a document is loaded in the RichEditControl, you can set the measurement unit with the Document.Unit property. The document setting is in effect until another document is loaded or a new document is created.