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

Copy[C#] Read only mode

radRichTextBox1.IsReadOnly = true;

Copy[VB.NET] Read only mode

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

Copy[C#] Bold, Italic, Underline

private void boldButton_Click(object sender, EventArgs e)
{
    this.radRichTextBox1.ToggleBold();
}

private void italicButton_Click(object sender, EventArgs e)
{
    this.radRichTextBox1.ToggleItalic();
}

private void underlineButton_Click(object sender, EventArgs e)
{
    this.radRichTextBox1.ToggleUnderline();
}

Copy[VB.NET] Bold, Italic, Underline

Private Sub boldButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles boldButton.Click
    Me.RadRichTextBox1.ToggleBold()
End Sub

Private Sub italicButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles italicButton.Click
    Me.RadRichTextBox1.ToggleItalic()
End Sub

Private Sub unserlineButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles underlineButton.Click
    Me.RadRichTextBox1.ToggleUnderline()
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:

Note
The same approach can be used for the CurrentParagraphStyleChanged event

Copy[C#] 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;
}

Copy[VB.NET] CurrentSpanStyleChanged and CurrentParagraphStyleChanged event handling

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

RadControls for WinForms

Formatting at design time

Formatting via a sample UI