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.
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.
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. | 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.