使用 WebBrowser 控件作为 HTML 文本编辑器[转]
作者： kevin delafield.
翻译： [yn]Yuxiang
C# (C# 2.0)
Windows, .NET (.NET 2.0)
Win32, VS (VS2005)
Dev
发表日期：2006-9-12
更新日期：2006-11-25
- 下载源文件(http: //www.codeproject.com/cs/miscctrl/editor_in_windows_forms/editor2_src.zip) - 42.3 Kb
- 下载演示项目(http: //www.codeproject.com/cs/miscctrl/editor_in_windows_forms/editor2_demo.zip) - 19.7 Kb
- 原文：A Windows Forms based text editor with HTML output
- 类似的控件：HTMLTextBox
简介
刚才，我在编写一个聊天应用程序，其中一个聊天客户端是基于 web 的并以 ASP.NET 2.0 编写，另一个聊天客户端是 C# 编写的基于 Windows 窗体的 .NET 应用。对于此 Windows 窗体客户端，我需要一个可以输出 HTML 的富文本编辑器(a rich text editor) ，以便于 ASP.NET 的客户端可以显示 Windows 窗体客户端的聊天内容。这样，就排除了使用 RTF 文本框的可能。
我设计出的解决方案是在 Windows 窗体客户端，以编辑模式使用一个 WebBrowser 控件。对于 WebBrowser 控件中选定的文本，同时在 WebBrowser 控件的上方放置包含格式按钮的工具栏，以便设置文本格式。
本文说明了这个方案中，使用 WebBrowser 控件建立一个编辑器时的主要难点问题。因为源代码不难理解，我就不深入介绍了。 但是，我会介绍一些必要的实现技巧。
WebBrowser 控件设计模式设置
当使用此组件时，会自动应用设计模式，并为文档建立一个编辑模板。但是，作为参考，下面简单说明这是如何实现的。
应用设计模式需要使用 COM 接口，添加一个 MSHTML 的 "Microsoft HTML Object Library" 的引用，并添加一个对 'MSHTML' 的 'using'。
在把改变写入到 DOM 文档之前，有必要添加一个 body 到控件。要这样做，你可以简单地设置一些文本到 WebBrowser 控件的 DocumentText 属性中。
webBrowser1.DocumentText = "<html><body></body></html>"
下面的代码可以取得新的 DomDocument COM 接口的引用，并设置设计模式为 "On"。
IHTMLDocument2 doc =
webBrowser1.Document.DomDocument as IHTMLDocument2;
doc.designMode = "On";
最后，我把 WebBrowser 控件的上下文菜单替换掉，这样 IE 浏览器的默认上下文菜单就不会显示出来。
webBrowser1.Document.ContextMenuShowing +=
new HtmlElementEventHandler(Document_ContextMenuShowing);
浏览器现在处于设计模式中，使用一个自定义方法来显示指定的上下文菜单。
格式化文本
使用 browser.Document 中的 ExecCommand 方法，你可以把格式和编辑功能应用到设计模式下的浏览器控件。
下面是一些例子：
public void Cut()
{
webBrowser1.Document.ExecCommand("Cut", false, null);
}
public void Paste()
{
webBrowser1.Document.ExecCommand("Paste", false, null);
}
public void Copy()
{
webBrowser1.Document.ExecCommand("Copy", false, null);
}
某些命令用于绑定(显示)当前选区的格式。
public void Bold()
{
webBrowser1.Document.ExecCommand("Bold", false, null);
}
public void Italic()
{
webBrowser1.Document.ExecCommand("Italic", false, null);
}
同步刷新选定文本的格式按钮
下面介绍一些比发出格式化命令到浏览器更有用的技巧。每 200 毫秒，我逐一查询浏览器编辑选区的状态，并据此设置工具栏格式按钮的状态。
private void timer_Tick(object sender, EventArgs e)
{
SetupKeyListener();
boldButton.Checked = IsBold();
italicButton.Checked = IsItalic();
underlineButton.Checked = IsUnderline();
orderedListButton.Checked = IsOrderedList();
unorderedListButton.Checked = IsUnorderedList();
linkButton.Enabled = SelectionType == SelectionType.Text;
UpdateFontComboBox();
UpdateFontSizeComboBox();
if (Tick != null) Tick();
}
你可能已经注意到这儿使用了一个 Tick 计时器事件。外部的组件可以订阅此事件来更新 GUI 的状态。举例来说，它们将基于编辑器控件的状态，刷新“剪切/复制/粘贴/撤销/重复”(操作)的 Enabled 状态。
我通过使用从 WebBrowser 控件返回的 COM 文档接口，来完成此任务，先使用：
IHTMLDocument2 doc = webBrowser1.Document.DomDocument as IHTMLDocument2;
然后，使用 queryCommandState 方法来确定当前选区的状态：
public bool IsBold()
{
return doc.queryCommandState("Bold");
}
public bool IsItalic()
{
return doc.queryCommandState("Italic");
}
public bool IsUnderline()
{
return doc.queryCommandState("Underline");
}
连接按钮和字体控件以一种简单的方式管理，但我将会保留以代码检测的方法。
取得焦点
让控件取得焦点不一定是简单的。 WebBrowser 控件本身不接受焦点。 WebBrowser 控件的文档也不接受焦点。但是，body 会取得焦点，可以假定有一个 body 元素在控件中。
private void SuperFocus()
{
if (webBrowser1.Document != null &&
webBrowser1.Document.Body != null)
webBrowser1.Document.Body.Focus();
}
当然，你决不需要直接调用此方法。在控件上调用 Focus 方法，会把焦点放置到包含了 WebBrowser 控件的编辑器控件上。当接收到 GotFocus 事件时，编辑器控件会自动把焦点转到 WebBrowser 控件文档的 body 上。
取得文本或 HTML
分别使用 BodyHtml 和 BodyText 方法，可以返回 HTML 和文本。
连接到组件程序集
在 Visual Studio 2005 中，你可以连接到一个程序集 (添加一个引用)，即使程序集是可执行的(文件)。此编辑器是作为内嵌在窗体的组件来编写的，因此你可以把这个组件添加到控件面板上，并把它拖放到你的应用程序中。此控件的名称为 Editor，在命名空间 Design 中。
结束语
.NET 2.0 中的 WebBrowser 控件可以作为一个有效的文本编辑器来使用。当你需要一个 HTML 编辑器控件时，它很有用。但是在某些范围内，不能完全直接地使用 WebBrowser 控件来实现。本文试图展示一些让它工作的必要技巧。