New to Telerik UI for WinForms? Download free 30-day trial

Getting Started with WinForms RichTextBox

WinForms RadRichTextBox Getting started with RadRichTextBox
In this video, we are going to see what it takes to get started with the RadRichTextBox. The RichTextBox control offers broad editing and formatting capabilities with true Word-like experience. You can load XAML, HTML, DOCX, RTF, or plain text document into the WinForms RichTextBox control. Each of these formats will allow you to edit and format the document, which can then be exported to/saved as any of the above mentioned supported formats, plus PDF. RadRichTextBox can also be used with RadRibbonBar for Windows Forms to give an Microsoft Office style look to your WinForms application. Also included is SpellChecking, Multi-region Selection and Editing and much much more.
WinForms RadRichTextBox richtextbox-getting-started 000

RadRichTextBox is a control that allows you to display rich text content including sections, paragraphs, spans, italic text, bold text, in-line images etc. This topic will help you to quickly get started using the control.

Formatting at design time

There are cases when you want to display a non-editable content that has been defined and formatted as far back as design time. In most of the cases the TextBlock control is used, but it doesn't provide you with a way to format your text in the same control instance. Although the RadRichTextBox is a rich text input control, it can also be used as a richtext viewer. In order to format the text inside it you can use the following classes:

  • Section

  • Paragraph

  • Span

  • InlineImage

As you can see the text is still editable. To make it read only you have to set the IsReadOnly property of the RadRichTextBox to True.

Read only mode

radRichTextBox1.IsReadOnly = true;

RadRichTextBox1.IsReadOnly = True

Formatting via a sample UI

If you want to allow the user to edit and format the content of the RadRichTextBox, you have tocreate a UI and use the API exposed by the RadRichTextBox. The API exposes methods (like ToggleBold(), ToggleItalic() etc.) that modify the text in the control when called. Here is an example of creating a UI for making the text bold, italic and underlined.

Bold, Italic, Underline

private void boldButton_Click(object sender, EventArgs e)
private void italicButton_Click(object sender, EventArgs e)
private void underlineButton_Click(object sender, EventArgs e)

Private Sub boldButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles boldButton.Click
End Sub
Private Sub italicButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles italicButton.Click
End Sub
Private Sub unserlineButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles underlineButton.Click
End Sub

The UI should also response, when the caret is on a position where the text is modified. For example, the boldButton should be toggled if the caret is on a bold text. This can be done by handling the CurrentSpanStyleChanged event. It is raised every time when the span, over which the caret is, gets changed. In the event handler you can use the CurrentEditingStyle property in order to get the desired information for the style of the current Span. This property is of type StyleDefinition and by using its GetPropertyValue() method and passing the appropriate DependancyProperty, you can get the desired information. This makes the StylesDefinition class universal for Span and Paragraph elements. Here is an example:

The same approach can be used for the CurrentParagraphStyleChanged event

CurrentSpanStyleChanged and CurrentParagraphStyleChanged event handling

void radRichTextBox1_CurrentSpanStyleChanged(object sender, EventArgs e)
    StyleDefinition style = this.radRichTextBox1.CurrentEditingStyle;
    TextStyle fontStyle = (TextStyle)style.GetPropertyValue(Span.FontStyleProperty);
    UnderlineType underlineDecoration = (UnderlineType)style.GetPropertyValue(Span.UnderlineTypeProperty);
    this.boldButton.IsChecked = fontStyle.HasFlag(TextStyle.Bold);
    this.italicButton.IsChecked = fontStyle.HasFlag(TextStyle.Italic);
    this.underlineButton.IsChecked = underlineDecoration != UnderlineType.None;

Private Sub radRichTextBox1_CurrentSpanStyleChanged(ByVal sender As Object, ByVal e As EventArgs)
    Dim style As StyleDefinition = Me.RadRichTextBox1.CurrentEditingStyle
    Dim fontStyle As TextStyle = DirectCast(style.GetPropertyValue(Span.FontStyleProperty), TextStyle)
    Dim underlineDecoration As UnderlineType = DirectCast(style.GetPropertyValue(Span.UnderlineTypeProperty), UnderlineType)
    Me.boldButton.IsChecked = fontStyle.HasFlag(TextStyle.Bold)
    Me.italicButton.IsChecked = fontStyle.HasFlag(TextStyle.Italic)
    Me.underlineButton.IsChecked = underlineDecoration <> UnderlineType.None
End Sub

In this article