RichTextBox 类 (System.Windows.Controls)

开启低带宽视图

全部折叠

语言筛选器

此页面仅适用于

Microsoft Visual Studio 2008/.NET Framework 3.5

同时提供下列产品的其他版本：

.NET Framework 3.0

.NET Framework 类库

RichTextBox 类

更新：2007 年 11 月

表示对 FlowDocument 对象执行操作的丰富编辑控件。

命名空间： System.Windows.Controls
程序集： PresentationFramework（在 PresentationFramework.dll 中）
用于 XAML 的 XMLNS：http://schemas.microsoft.com/winfx/xaml/presentation

语法

Visual Basic（声明）

<LocalizabilityAttribute(LocalizationCategory.Inherit)> _
<ContentPropertyAttribute("Document")> _
Public Class RichTextBox _
    Inherits TextBoxBase _
    Implements IAddChild

Visual Basic (用法)

Dim instance As RichTextBox

[LocalizabilityAttribute(LocalizationCategory.Inherit)]
[ContentPropertyAttribute("Document")]
public class RichTextBox : TextBoxBase, 
    IAddChild

Visual C++

[LocalizabilityAttribute(LocalizationCategory::Inherit)]
[ContentPropertyAttribute(L"Document")]
public ref class RichTextBox : public TextBoxBase, 
    IAddChild

/** @attribute LocalizabilityAttribute(LocalizationCategory.Inherit) */
/** @attribute ContentPropertyAttribute("Document") */
public class RichTextBox extends TextBoxBase implements IAddChild

JScript

public class RichTextBox extends TextBoxBase implements IAddChild

XAML 对象元素用法

<RichTextBox>
  Document
</RichTextBox>

备注

FlowDocument 是 RichTextBox 支持的唯一子元素。

重要说明：
RichTextBox 可对冒泡MouseUp 和 MouseDown 事件进行内置处理。因此，从不会调用侦听来自 RichTextBox 的 MouseUp 或 MouseDown 事件的自定义事件处理程序。如果需要响应这些事件，应侦听隧道PreviewMouseUp 和 PreviewMouseDown 事件，或者使用 HandledEventsToo 参数注册处理程序（后一种选择只能通过代码实现）。除非您有意要禁用这些事件的 RichTextBox 本机处理，否则请不要将事件标记为已处理，同时要注意，这样做会对控件的 UI 产生显著影响。

重要说明：

RichTextBox 可对冒泡MouseUp 和 MouseDown 事件进行内置处理。因此，从不会调用侦听来自 RichTextBox 的 MouseUp 或 MouseDown 事件的自定义事件处理程序。如果需要响应这些事件，应侦听隧道PreviewMouseUp 和 PreviewMouseDown 事件，或者使用 HandledEventsToo 参数注册处理程序（后一种选择只能通过代码实现）。除非您有意要禁用这些事件的 RichTextBox 本机处理，否则请不要将事件标记为已处理，同时要注意，这样做会对控件的 UI 产生显著影响。

虽然 RichTextBox 支持复制和粘贴图像，但目前不支持某些特定方案，这些方案可能无法正确运行。下表总结了这些方案和预期结果。

图像复制源	图像粘贴结果
图像源是图形图元文件	没有粘贴图像
图像源使用相对路径或链接	粘贴了乱码或空白图像
图像源链接没有以预期图像格式（.PNG、.JPG、.GIF）结尾	粘贴了乱码或空白图像
从格式不正确的 RichText (RTF) 复制的图像源	粘贴了图像源的链接（而非图像）

将 HTML 内容粘贴到 RichTextBox 中可能导致意外行为，因为 RichTextBox 使用 RTF 格式，而不是直接使用 HTML 格式。

文本在 RichTextBox 中总是换行。如果不希望文本换行，请将 FlowDocument 上的 PageWidth 设置为大于 RichTextBox 的宽度。但是，一旦达到该页宽，文本仍会换行。

可通过 HorizontalContentAlignment 和 VerticalContentAlignment 属性在水平和垂直方向上对齐 RichTextBox 中的内容。可通过 HorizontalAlignment 和 VerticalAlignment 属性对齐页面布局中的 RichTextBox。

默认情况下，滚动条在 RichTextBox 上不可见。若要使滚动条可见，请将 VerticalScrollBarVisibility 属性设置为 Visible 或 Auto。

通常，当 TextBox 或 RichTextBox 中的文本更改时，应使用 TextChanged 事件进行检测，而不是使用您可能认为的 KeyDown。有关示例，请参见如何：检测 TextBox 中的文本何时更改。

RichTextBox 支持多种键盘命令。有关键盘命令的列表，请参见 EditingCommands。

示例

下面的示例声明一个包含简单 FlowDocument 的 RichTextBox。

<RichTextBox Name="richTB">
  <FlowDocument>
    <Paragraph>
      <Run>Paragraph 1</Run>
    </Paragraph>
    <Paragraph>
      <Run>Paragraph 2</Run>
    </Paragraph>
    <Paragraph>
      <Run>Paragraph 3</Run>
    </Paragraph>
  </FlowDocument>
</RichTextBox>

using System;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Media;
using System.Windows.Documents;
namespace SDKSample
{
    public partial class RichTextBoxExample : Page
    {
        public RichTextBoxExample()
        {

            StackPanel myStackPanel = new StackPanel();

            // Create a FlowDocument to contain content for the RichTextBox.
            FlowDocument myFlowDoc = new FlowDocument();

            // Add paragraphs to the FlowDocument.
            myFlowDoc.Blocks.Add(new Paragraph(new Run("Paragraph 1")));
            myFlowDoc.Blocks.Add(new Paragraph(new Run("Paragraph 2")));
            myFlowDoc.Blocks.Add(new Paragraph(new Run("Paragraph 3")));
            RichTextBox myRichTextBox = new RichTextBox();

            // Add initial content to the RichTextBox.
            myRichTextBox.Document = myFlowDoc;

            myStackPanel.Children.Add(myRichTextBox);
            this.Content = myStackPanel;

        }
    }
}

.NET Framework

受以下版本支持：3.5、3.0

另请参见

参考

RichTextBox 成员

System.Windows.Controls 命名空间

其他资源

标记

: 添加标记

社区内容

添加新内容

批注

个人信息中心 | 法律信息 | MSDN Flash 中心 | 联系我们

如何：从 RichTextBox 中提取文本内容	此示例演示如何将一个 RichTextBox 的内容提取为纯文本。
如何：在 RichTextBox 中定位自定义上下文菜单	本示例演示如何定位 RichTextBox 的自定义上下文菜单。
如何：替换 RichTextBox 的默认内容宿主	本示例演示如何使用 Windows Presentation Foundation (WPF) 样式来替换 RichTextBox 的默认内容宿主。

更多代码

.NET Framework

参考

其他资源