RichTextBox::SelectionAlignment Property
Gets or sets the alignment to apply to the current selection or insertion point.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: [BrowsableAttribute(false)] property HorizontalAlignment SelectionAlignment { HorizontalAlignment get(); void set(HorizontalAlignment value); }
Property Value
Type: System.Windows.Forms::HorizontalAlignmentOne of the HorizontalAlignment values.
| Exception | Condition |
|---|---|
| InvalidEnumArgumentException | The specified value is not one of the values defined in the HorizontalAlignment class. |
If no paragraph is selected in the control, setting this property applies the alignment setting to the paragraph in which the insertion point appears as well as to paragraphs created after the paragraph that has the alignment property setting. For example, if there are two paragraphs in a RichTextBox control and the insertion point is located within the second paragraph. If you set the SelectionAlignment property to HorizontalAlignment.Center, the paragraph at the insertion point will be centered within the control. If a third paragraph is created after the second paragraph, it also is aligned to the center of the control.
If a selection is made within the control when the property is set, all paragraphs selected are aligned based on this property setting. You can use this property to align the paragraphs in a document being created in the RichTextBox. For example, if you want all paragraphs in a document to be centered, you can select all the paragraphs in the control and set the SelectionAlignment property to HorizontalAlignment.Center.
Note |
|---|
SelectionAlignment returns SelectionAlignment.Left when the text selection contains multiple paragraphs with mixed alignment. |
The following code example demonstrates how to align text within the RichTextBox. This example requires that a RichTextBox control, named richTextBox1, has been added to the form.
private: void WriteCenteredTextToRichTextBox() { // Clear all text from the RichTextBox; richTextBox1->Clear(); // Set the foreground color of the text. richTextBox1->ForeColor = Color::Red; // Set the alignment of the text that follows. richTextBox1->SelectionAlignment = HorizontalAlignment::Center; // Set the font for the text. richTextBox1->SelectionFont = gcnew System::Drawing::Font( "Lucinda Console",12 ); // Set the text within the control. richTextBox1->SelectedText = "This text is centered using the SelectionAlignment property.\n"; }
Available since 1.1
