SelectionHangingIndent Property

RichTextBox.SelectionHangingIndent Property


Gets or sets the distance between the left edge of the first line of text in the selected paragraph and the left edge of subsequent lines in the same paragraph.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public int SelectionHangingIndent { get; set; }

Property Value

Type: System.Int32

The distance, in pixels, for the hanging indent applied to the current text selection or the insertion point.

If no text is currently selected, the hanging indent is applied to the paragraph in which the insertion point appears and to all text that is typed into the control after the insertion point. The hanging indent setting applies until the property is changed to a different value or until the insertion point is moved to a different paragraph within the control.

If text is selected within the control, the selected text and any text entered after the text selection will have the value of this property applied to it. You can use this property to apply a hanging indent to your paragraphs.

To set the indention of the first line of a paragraph selection, use the SelectionIndent property.

The following code example demonstrates how to specify hanging indents within the RichTextBox using the SelectionHangingIndent property. This example requires that a RichTextBox control, named richTextBox1, has been added to the form.

private void WriteIndentedTextToRichTextBox()
   // Clear all text from the RichTextBox;
   // Specify a 20 pixel hanging indent in all paragraphs.
   richTextBox1.SelectionHangingIndent = 20;
   // Set the font for the text.
   richTextBox1.Font = new Font("Lucinda Console", 12);
   // Set the text within the control.
   richTextBox1.SelectedText = "This text contains a hanging indent. The first sentence of the paragraph is spaced normally.";
   richTextBox1.SelectedText = "All subsequent lines of text are indented based on the value of SelectionHangingIndent.";
   richTextBox1.SelectedText = "After this paragraph the indent is returned to normal spacing.\n";
   richTextBox1.SelectedText = "Since this is a new paragraph the indent is also applied to this paragraph.";
   richTextBox1.SelectedText = "All subsequent lines of text are indented based on the value of SelectionHangingIndent.";

.NET Framework
Available since 1.1
Return to top
© 2016 Microsoft