在Sl中,有TextBox,TextBlock,RichTextBox这3个核心的文本控件,从表面上看,RichTextBox看起来和一个普通的TextBox并
没有太多的区别,实际上它提供了诸如格式化文本,段落,超链接,内联图像这些功能,它甚至可以显示任何UIElement,比如DataGrid。
MSDN有关于RichTextBox内容模型的一个关系图
RichTextBox的内容属性是Blocks,这是一个Paragraph的集合,这些Paragraph可以包含Inline元素派生的元素。 比如Run,
Span,Bold,Italic,Hyperlink,InlineUIContainer,其实从图中你可能会注意到Hyperlink比较特殊,它不能包含其它Inline类型的元素。
下面熟悉RichTextBox中一些简单的属性:
添加RichTextBox:
<RichTextBox AcceptsReturn="True"
x:Name="rbtMyRichTextBox">
RichTextBox常用的属性包括AcceptReturn和IsReadOnly属性,只有在只读模式下,UI元素才是可用的。
添加元素:
前面已经提到,RichTextBox包含了Paragraph集合,所以我们可以轻易添加任何内联元素,那么这里我们看一看在一个Paragraph
中添加多个元素的Code
Run rnMyText = new Run();
rnMyText.Text = "This is some example text with a ";
prgParagraph.Inlines.Add(rnMyText);
Hyperlink lnkSSLink = new Hyperlink();
lnkSSLink.Inlines.Add("link to Silverlight Show");
lnkSSLink.NavigateUri = new Uri("http://www.cnblogs.com");
prgParagraph.Inlines.Add(lnkSSLink);
rbtMyRichTextBox.Blocks.Add(prgParagraph);
上面的代码中,添加了一些文本和一个超链接,那么首先要做的是实例化一个Paragraph,在这个Paragraph中,我们添加了文本和
超链接,这些对象被添加到该Paragraph中的Inlines集合中,最后将这个Paragraph添加到了RichTextBox中
格式文本对象:
Run元素只能包含非格式化的文本,如果想要对文本进行格式化,那么可以采用变通的方式,即将Run元素包含在内联的格式元素中
Bold bldText = new Bold();
bldText.Inlines.Add(new Run() { Text = "This is some example text in bold" });
Italic itlText = new Italic();
itlText.Inlines.Add(new Run() { Text = "This is some example text in italics" });
Underline unText = new Underline();
unText.Inlines.Add(new Run() { Text = "This is some example text, underlined" });
Bold bldTextWithItalic = new Bold();
bldTextWithItalic.Inlines.Add(new Italic() { Inlines = { new Run(){ Text = "This is some example text, bold and italic" } } });
prgParagraph.Inlines.Add(bldText);
prgParagraph.Inlines.Add(new LineBreak());
prgParagraph.Inlines.Add(itlText);
prgParagraph.Inlines.Add(new LineBreak());
prgParagraph.Inlines.Add(unText);
prgParagraph.Inlines.Add(new LineBreak());
prgParagraph.Inlines.Add(bldTextWithItalic);
rbtMyRichTextBox.Blocks.Add(prgParagraph);
上面的代码分别实现了文本的加粗,倾斜,下滑线功能,和添加元素的代码没有太大区别
添加InlineUIContainer:
顾名思义,这个元素就是UI元素的容器,当我们想要在内容中添加Image,DataGrid这些元素的时候,它非常的方便,步骤也是和其它内联元素一样的
先创建一个InlineUIContainer,然后在容器中添加UIElement,把这个容器添加到Paragraph中
DataGrid dtgGrid = new DataGrid();
dtgGrid.AutoGenerateColumns = true;
dtgGrid.Width = 400;
dtgGrid.Height = 200;
dtgGrid.ItemsSource = ...
iuicContainer.Child = dtgGrid;
Paragraph prgParagraph = new Paragraph();
prgParagraph.Inlines.Add(iuicContainer);
rbtMyRichTextBox.Blocks.Add(prgParagraph);
上面的CODE如果改成XAML声明:
Margin="5"
x:Name="rbtMyRichTextBox">
<Paragraph>
<InlineUIContainer>
<Image Source="Assets/logo.png" Width="100"></Image>
</InlineUIContainer>
</Paragraph>
</RichTextBox>
通过上面的内容已经对RichTextBox有了基本的了解,其实之前我们都是通过编程的方式加入这些元素,但是更为常见的场景是
用户可以通过选择某些文本,并对选中的文本进行加粗等操作,RichTextBox提供了一个类型为TextSelection的Selection属性,
它包含了当前被选择的文本,然后我们可以通过GetPropertyValue和ApplyPropertyValue方法对选择的文本进行操作
操作Selection:
{
if (rbtMyRichTextBox.Selection.GetPropertyValue(Run.FontWeightProperty) is FontWeight
&& ((FontWeight)rbtMyRichTextBox.Selection.GetPropertyValue(Run.FontWeightProperty)) == FontWeights.Normal)
{
rbtMyRichTextBox.Selection.ApplyPropertyValue(Run.FontWeightProperty, FontWeights.Bold);
}
else
{
rbtMyRichTextBox.Selection.ApplyPropertyValue(Run.FontWeightProperty, FontWeights.Normal);
}
}
if (rbtMyRichTextBox != null)
{
rbtMyRichTextBox.Focus();
}
上面的代码中,我们获取了选中文本的FontWeight属性,通过检查它是Normal还是Bold改变其值,这里的逻辑也可以用在
FontSize等其它的属性上。
简单的复制,剪切,粘贴功能:
Sl4支持Clipboard功能,所以通过访问Clipboard我们可以很容易实现剪切,复制功能
{
Clipboard.SetText(rbtMyRichTextBox.Selection.Text);
rbtMyRichTextBox.Focus();
}
private void Cut_Click(object sender, RoutedEventArgs e)
{
Clipboard.SetText(rbtMyRichTextBox.Selection.Text);
rbtMyRichTextBox.Selection.Text = "";
rbtMyRichTextBox.Focus();
}
上面的代码分别演示如何对RichTextBox中被选中的文本进行复制,剪切
{
rbtMyRichTextBox.Selection.Text = Clipboard.GetText();
rbtMyRichTextBox.Focus();
}
复制的时候,如果RichTextBox没有选择任何元素,那么剪切板上的文本将显示在鼠标的当前位置上。注意的是,Cilpboard只能保护简单
的文本,所以当粘贴,复制的时候会丢失之前格式化的信息。
保存内容为文件:
RichTextBox提供了一个名为Xaml的属性,通过这个属性可以很方便的将内容保存为文件
{
var uiElements = from block in rbtMyRichTextBox.Blocks
from inline in (block as Paragraph).Inlines
where inline.GetType() == typeof(InlineUIContainer)
select inline;
if (uiElements.Count() != 0)
{
MessageBox.Show("UIElements cannot be saved");
return;
}
SaveFileDialog sfdSaveXaml = new SaveFileDialog();
sfdSaveXaml.DefaultExt = ".sav";
sfdSaveXaml.Filter = "Saved rtb files|*.rtb";
if (sfdSaveXaml.ShowDialog().Value)
{
using (FileStream fs = (FileStream)sfdSaveXaml.OpenFile())
{
System.Text.UTF8Encoding enc = new System.Text.UTF8Encoding();
byte[] buffer = enc.GetBytes(rbtMyRichTextBox.Xaml);
fs.Write(buffer, 0, buffer.Length);
fs.Close();
}
}
}
因为RichTextBox不支持保存InlineUIContainer的元素,所以上面的代码中先将其排除,然后通过FileStream保存
打开文件:
这个与保存文件过程是相反的,只要将RichTextBox的Xaml属性设置为读出的XAML
{
OpenFileDialog ofdOpenXaml = new OpenFileDialog();
ofdOpenXaml.Multiselect = false;
ofdOpenXaml.Filter = "Saved rtb files|*.rtb";
if (ofdOpenXaml.ShowDialog().Value)
{
FileInfo fiXamlFile = ofdOpenXaml.File;
StreamReader sr = fiXamlFile.OpenText();
rbtMyRichTextBox.Xaml = sr.ReadToEnd();
sr.Close();
}
}
上面的保存,读取的文件只支持rtb格式的,其实可以使用其它的格式,当然肯定需要额外的编码,比如你打开一个文本文件,那么
首先需要你创建所必须的Run标记。总之,你需要将内容转换成Xaml格式。
对于保存文件,可以看看CodePlex上一个开眼项目:WordToXaml