Introduction
While playing around with WPF, I got stuck with the RichTextBox and their possibilities in comparison to the RichTextBox in WinFoms.
So I tried to develop a UserControl with the basic text-formatting functions in WPF.
This article is it.
I want to point out that I did use the Color Picker from Sacha Barber's article:
The Icons are from:
Using the Code
So, how does it all work. It is rather simple, my RTF-Editor is a WPF UserControl-Project.
It can easily be used like I demonstrated it in my TestApplication whose XAML looks like this:
<Window x:Class="TestApp.Window1"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:rtf="clr-namespace:RTFEditor;assembly=RTFEditor"
Title="Window1" Height="300" Width="300">
<DockPanel>
<rtf:RTFBox></rtf:RTFBox>
</DockPanel>
</Window>
The RTFBox class is my RTF-Editor.
The UserInterface consists of a RichTextBox, a StatusBar and two ToolBars which hold all the buttons for text-formatting.
The first toolbars XAML looks like this:
<ToolBar x:Name="ToolBarOben" DockPanel.Dock="Top">
<Button x:Name="ToolStripButtonOpen"
Click="ToolStripButtonOpen_Click">
<Image Source="Images\Open.png" Stretch="None"/>
</Button>
<Button x:Name="ToolStripButtonPrint"
Click="ToolStripButtonPrint_Click">
<Image Source="Images\Print.png" Stretch="None"/>
</Button>
<Separator/>
<Button x:Name="ToolStripButtonCut"
Command="ApplicationCommands.Cut" ToolTip="Cut">
<Image Source="Images\Cut.png" Stretch="None"/>
</Button>
<Button x:Name="ToolStripButtonCopy"
Command="ApplicationCommands.Copy" ToolTip="Copy">
<Image Source="Images\Copy.png" Stretch="None"/>
</Button>
<Button x:Name="ToolStripButtonPaste"
Command="ApplicationCommands.Paste" ToolTip="Paste">
<Image Source="Images\Paste.png" Stretch="None"/>
</Button>
<Button x:Name="ToolStripButtonUndo"
Command="ApplicationCommands.Undo" ToolTip="Undo">
<Image Source="Images\Undo.png" Stretch="None"/>
</Button>
<Button x:Name="ToolStripButtonRedo"
Command="ApplicationCommands.Redo" ToolTip="Redo">
<Image Source="Images\Redo.png" Stretch="None"/>
</Button>
<Separator/>
<ComboBox x:Name="Fonttype" ItemsSource="{Binding Mode=OneWay,
Source={StaticResource FontListKlasse}}"
DropDownClosed="Fonttype_DropDownClosed" />
<ComboBox x:Name="Fontheight" ItemsSource="{Binding Mode=OneWay,
Source={StaticResource FontHeightKlasse}}"
DropDownClosed="Fontheight_DropDownClosed" />
</ToolBar>
As you can see, it is really straightforward. I used the ApplicationCommands for Cut, Copy, Paste, Undo, Redo and defined the necessary Handler for Open, Print.
A bit more complex are the ComboBoxes for FontType and FontHeight. I used a OneWay Binding to static resources that I defined in my XAML like this:
<UserControl.Resources>
<ObjectDataProvider x:Key="FontListKlasse" d:IsDataSource="True"
ObjectType="{x:Type RTFEditor:FontList}"/>
<ObjectDataProvider x:Key="FontHeightKlasse" d:IsDataSource="True"
ObjectType="{x:Type RTFEditor:FontHeight}"/>
</UserControl.Resources>
Here are the two classes FontHeight and FontList that hold the information.
class FontList : ObservableCollection<string>
{
public FontList()
{
foreach (FontFamily f in Fonts.SystemFontFamilies)
{
this.Add(f.ToString());
}
}
}
class FontHeight : ObservableCollection<string>
{
public FontHeight()
{
this.Add("8");
this.Add("9");
this.Add("10");
this.Add("11");
this.Add("12");
this.Add("14");
this.Add("16");
this.Add("18");
this.Add("20");
this.Add("22");
this.Add("24");
this.Add("26");
this.Add("28");
this.Add("36");
this.Add("48");
this.Add("72");
}
}
The second ToolBar is similar so without pasting the full XAML code:
I used ToggleButtons for the textstyle (bold, italic, ...) and textalignment(right, left, ...).
If possible, I used EditingCommands like this:
<ToggleButton x:Name="ToolStripButtonBold"
Command="EditingCommands.ToggleBold"
ToolTip="Bold">
<Image Source="Images\Bold.png" Stretch="None"/>
</ToggleButton>
There is no EditingCommand for strikethrough formatting, so I did this via TextDecorations:
private void ToolStripButtonStrikeout_Click(object sender,
System.Windows.RoutedEventArgs e)
{
TextRange range = new TextRange(RichTextControl.Selection.Start,
RichTextControl.Selection.End);
TextDecorationCollection tdc =
(TextDecorationCollection)RichTextControl.
Selection.GetPropertyValue(Inline.TextDecorationsProperty);
if (tdc == null || !tdc.Equals(TextDecorations.Strikethrough))
{
tdc = TextDecorations.Strikethrough;
}
else
{
tdc = new TextDecorationCollection();
}
range.ApplyPropertyValue(Inline.TextDecorationsProperty, tdc);
}
As there is no ColorDialog in WPF like the one in WinForms, I used one from Sacha Barber for Textforecolor and Textbackgroundcolor.
private void ToolStripButtonTextcolor_Click
(object sender, RoutedEventArgs e)
{
ColorDialog colorDialog = new ColorDialog();
if ((bool)colorDialog.ShowDialog())
{
TextRange range = new TextRange(RichTextControl.Selection.Start,
RichTextControl.Selection.End);
range.ApplyPropertyValue(FlowDocument.ForegroundProperty,
new SolidColorBrush(colorDialog.SelectedColor));
}
}
For superscript and subscript exist EditingCommands but they do only work for OpenType Fonts. So instead of using them, I changed BaselineAlignments to display sub/superscript for all fonts like this:
private void ToolStripButtonSubscript_Click(object sender, RoutedEventArgs e)
{
var currentAlignment =
RichTextControl.Selection.GetPropertyValue
(Inline.BaselineAlignmentProperty);
BaselineAlignment newAlignment =
((BaselineAlignment)currentAlignment ==
BaselineAlignment.Subscript) ?
BaselineAlignment.Baseline :
BaselineAlignment.Subscript;
RichTextControl.Selection.ApplyPropertyValue
(Inline.BaselineAlignmentProperty,
newAlignment);
}
I added a Statusbar for displaying the line and columnnumber and a zoom function. The XAML is straightforward.
To get the line number, I had to start from the beginning and count all lines to the current cursor position like this:
private int LineNumber()
{
TextPointer caretLineStart =
RichTextControl.CaretPosition.GetLineStartPosition(0);
TextPointer p = RichTextControl.Document.ContentStart.GetLineStartPosition(0);
int currentLineNumber = 1;
while (true)
{
if (caretLineStart.CompareTo(p) < 0)
{
break;
}
int result;
p = p.GetLineStartPosition(1, out result);
if (result == 0)
{
break;
}
currentLineNumber++;
}
return currentLineNumber;
}
To get the column number, I could use the GetOffsetToPosition function like this:
private int ColumnNumber()
{
TextPointer caretPos = RichTextControl.CaretPosition;
TextPointer p = RichTextControl.CaretPosition.GetLineStartPosition(0);
int currentColumnNumber = Math.Max(p.GetOffsetToPosition(caretPos) - 1, 0);
return currentColumnNumber;
}
At this point I realized that the WinForms RichTextBox offers a zoom function, the WPF RichTextBox doesn't. I did not find a way to implement one. (Any help in this regard will be appreciated.)
After I finished with the mentioned basic Texteditor functions, I wanted a possibility to get the RTF-content out of the RichTextControl, means the text with the rich text formatting. The WPF RichTextBox holds no straightforward way to get this so I did this:
public string GetRTF()
{
TextRange range = new TextRange(RichTextControl.Document.ContentStart,
RichTextControl.Document.ContentEnd);
try
{
using (MemoryStream rtfMemoryStream = new MemoryStream())
{
using (StreamWriter rtfStreamWriter =
new StreamWriter(rtfMemoryStream))
{
range.Save(rtfMemoryStream, DataFormats.Rtf);
rtfMemoryStream.Flush();
rtfMemoryStream.Position = 0;
StreamReader sr = new StreamReader(rtfMemoryStream);
return sr.ReadToEnd();
}
}
}
catch (Exception)
{
throw;
}
}
And the other direction looks like this:
public void SetRTF(string rtf)
{
TextRange range = new TextRange(RichTextControl.Document.ContentStart,
RichTextControl.Document.ContentEnd);
try
{
using (MemoryStream rtfMemoryStream = new MemoryStream())
{
using (StreamWriter rtfStreamWriter =
new StreamWriter(rtfMemoryStream))
{
rtfStreamWriter.Write(rtf);
rtfStreamWriter.Flush();
rtfMemoryStream.Seek(0, SeekOrigin.Begin);
range.Load(rtfMemoryStream, DataFormats.Rtf);
}
}
}
catch (Exception)
{
throw;
}
}
Your Opinion
I'm very interested in your opinion about the article and the code. Please leave some comments and let me know if the article could help you in any way.
History
- 5th January, 2010: Initial post
