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.

RTETabsAlignment

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.

RichEdit_ShowRulers

You can specify whether to hide or display rulers using the RulerOptions.Visibility property, as shown below:

RichEditControlOptions richEditControlOptions = richEditControl.Options;

richEditControlOptions.VerticalRuler.Visibility = RichEditRulerVisibility.Hidden;
richEditControlOptions.HorizontalRuler.Visibility = RichEditRulerVisibility.Hidden;

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 or vertical 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

Rulers show the DocumentUnit.Document (1/300 of an inch) measurement units. Specify the the RichEditControl.Unit property to change the rulers' measurements. 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.