在 WPF 中，RichTextBox 是一个功能强大的控件，用于显示和编辑富文本内容，支持格式化文本（如粗体、斜体、颜色）、嵌入图像、超链接等。它继承自 TextBoxBase，适合需要复杂文本编辑的场景。在 ProjectEditView.xaml 上下文中，RichTextBox 可用于编辑测试说明、记录测试日志或显示格式化的通道配置详情。以下是对 RichTextBox 控件的所有主要属性的详细中文解析，涵盖其功能、用途、适用场景以及在 ProjectEditView.xaml 中的潜在应用。每个属性将附带代码示例，并结合工程参数配置场景说明其作用。

一、RichTextBox 控件概述

功能：

  • RichTextBox 支持富文本编辑，允许用户输入和显示格式化文本、图像、表格等。
  • 提供高级文本操作，如复制/粘贴、拼写检查、撤销/重做。
  • 支持数据绑定、命令和自定义样式，适合 MVVM 模式。

在 ProjectEditView.xaml 上下文中的潜在用途：

  • 测试说明：编辑或显示测试条件的详细说明（如 TimeStopper 的描述）。
  • 测试日志：记录测试过程中的富文本日志（如时间戳、状态变化）。
  • 通道详情：显示通道的格式化信息（如高亮关键参数）。
  • 用户注释：允许用户为测试配置添加注释。

适用场景：

  • 富文本编辑：编辑测试说明或注释。
  • 日志记录：记录格式化的测试日志。
  • 信息展示：显示通道或参数的富文本详情。
  • 动态交互：结合 MVVM 模式，实时更新或保存文本内容。

二、RichTextBox 属性详解

以下是 RichTextBox 控件的主要属性，按照功能分类进行详细解析，包含功能、用法、适用场景和代码示例。

1. 文本内容相关属性
(1) Document
  • 功能：
    • 指定 RichTextBox 的内容，类型为 FlowDocument，包含文本、段落、图像等。
  • 用法：
    • 直接在 XAML 中定义或通过代码操作。
  • 适用场景：
    • 显示测试说明的格式化内容。
  • 代码示例：
    <RichTextBox>
    <FlowDocument>
        <Paragraph>
            <Run Text="测试说明：" FontWeight="Bold"/>
            <Run Text="{Binding ProjectModel.TestDescription}"/>
        </Paragraph>
    </FlowDocument>
</RichTextBox>

    public class ProjectModel
{
    public string TestDescription { get; set; } = "此测试用于验证通道性能。";
}
  • 作用：
    • 定义富文本内容。
(2) Text (非直接属性，通过代码操作)
  • 功能：
    • 获取或设置 RichTextBox 的纯文本内容（需通过 Document 操作）。
  • 用法：
    • 使用 TextRange 获取或设置文本。
  • 适用场景：
    • 保存或加载测试日志的纯文本。
  • 代码示例：
    <RichTextBox x:Name="LogRichTextBox"/>
<Button Content="保存日志" Command="{Binding SaveLogCommand}"/>

    public DelegateCommand SaveLogCommand { get; }
private void SaveLog()
{
    var textRange = new TextRange(LogRichTextBox.Document.ContentStart, LogRichTextBox.Document.ContentEnd);
    string text = textRange.Text;
    Console.WriteLine($"保存日志: {text}");
}
  • 作用：
    • 操作纯文本内容。
(3) AcceptsReturn 和 AcceptsTab
  • 功能：
    • AcceptsReturn：控制是否允许输入回车换行（默认 True）。
    • AcceptsTab：控制是否允许输入制表符（默认 True）。
  • 用法：
    • 设置为 False 限制特定输入。
  • 适用场景：
    • 限制测试说明的格式。
  • 代码示例：
    <RichTextBox AcceptsReturn="True" AcceptsTab="False"/>
  • 作用：
    • 控制输入行为。
2. 编辑相关属性
(4) IsReadOnly
  • 功能：
    • 控制 RichTextBox 是否为只读（默认 False）。
  • 用法：
    • 绑定到 ViewModel 属性，动态控制编辑状态。
  • 适用场景：
    • 显示只读的测试日志。
  • 代码示例：
    <RichTextBox IsReadOnly="{Binding IsLogReadOnly}"/>

    private bool _isLogReadOnly = true;
public bool IsLogReadOnly
{
    get => _isLogReadOnly;
    set => SetProperty(ref _isLogReadOnly, value);
}
  • 作用：
    • 控制编辑权限。
(5) IsDocumentEnabled
  • 功能：
    • 控制 FlowDocument 中的交互元素（如超链接）是否可用（默认 False）。
  • 用法：
    • 设置为 True 启用超链接或嵌入控件。
  • 适用场景：
    • 在测试说明中添加可点击的超链接。
  • 代码示例：
    <RichTextBox IsDocumentEnabled="True">
    <FlowDocument>
        <Paragraph>
            <Hyperlink NavigateUri="https://example.com" RequestNavigate="Hyperlink_RequestNavigate">查看测试文档</Hyperlink>
        </Paragraph>
    </FlowDocument>
</RichTextBox>

    private void Hyperlink_RequestNavigate(object sender, RequestNavigateEventArgs e)
{
    System.Diagnostics.Process.Start(new System.Diagnostics.ProcessStartInfo(e.Uri.ToString()) { UseShellExecute = true });
}
  • 作用：
    • 启用交互元素。
(6) UndoEnabled 和 IsUndoEnabled
  • 功能：
    • 控制是否启用撤销/重做功能（默认 True）。
  • 用法：
    • 设置为 False 禁用撤销以节省资源。
  • 适用场景：
    • 禁用测试日志的撤销功能。
  • 代码示例：
    <RichTextBox IsUndoEnabled="False"/>
  • 作用：
    • 控制撤销功能。
3. 外观相关属性
(7) Background, Foreground, BorderBrush, BorderThickness
  • 功能：
    • 设置背景、前景、边框颜色和厚度。
  • 用法：
    • 与界面主题一致。
  • 适用场景：
    • 突出测试日志区域。
  • 代码示例：
    <RichTextBox Background="White" BorderBrush="Gray" BorderThickness="1"/>
  • 作用：
    • 增强视觉效果。
(8) FontFamily, FontSize, FontWeight, FontStyle
  • 功能：
    • 设置文本的字体、字号、粗细和样式。
  • 用法：
    • 直接设置或通过样式定义。
  • 适用场景：
    • 统一测试说明的字体样式。
  • 代码示例：
    <RichTextBox FontFamily="Segoe UI" FontSize="14" FontWeight="Bold"/>
  • 作用：
    • 控制文本外观。
(9) Style
  • 功能：
    • 应用自定义样式，控制 RichTextBox 的外观和行为。
  • 用法：
    • 定义触发器或动画。
  • 适用场景：
    • 根据测试状态调整日志区域样式。
  • 代码示例：
    <Style x:Key="LogRichTextBoxStyle" TargetType="RichTextBox">
    <Setter Property="Background" Value="White"/>
    <Setter Property="BorderThickness" Value="1"/>
    <Style.Triggers>
        <DataTrigger Binding="{Binding IsTestRunning}" Value="True">
            <Setter Property="BorderBrush" Value="Green"/>
        </DataTrigger>
    </Style.Triggers>
</Style>
<RichTextBox Style="{StaticResource LogRichTextBoxStyle}"/>
  • 作用：
    • 提供一致的视觉效果。
4. 交互相关属性
(10) IsEnabled
  • 功能：
    • 控制 RichTextBox 是否可交互（默认 True）。
  • 用法：
    • 绑定到 ViewModel 属性，动态启用/禁用。
  • 适用场景：
    • 禁用测试日志编辑。
  • 代码示例：
    <RichTextBox IsEnabled="{Binding IsLogEditable}"/>

    private bool _isLogEditable = false;
public bool IsLogEditable
{
    get => _isLogEditable;
    set => SetProperty(ref _isLogEditable, value);
}
  • 作用：
    • 控制交互性。
(11) Visibility
  • 功能：
    • 控制 RichTextBox 的可见性（Visible、Hidden、Collapsed）。
  • 用法：
    • 绑定到 ViewModel 属性，动态显示或隐藏。
  • 适用场景：
    • 根据测试状态显示日志区域。
  • 代码示例：
    <RichTextBox Visibility="{Binding IsTestRunning, Converter={StaticResource BooleanToVisibilityConverter}}"/>
  • 作用：
    • 动态控制显示。
(12) TextChanged
  • 功能：
    • 事件属性，在文本内容更改时触发。
  • 用法：
    • 使用 Interaction.Triggers 绑定到命令。
  • 适用场景：
    • 在用户编辑测试说明时保存更改。
  • 代码示例：
    <RichTextBox>
    <i:Interaction.Triggers>
        <i:EventTrigger EventName="TextChanged">
            <i:InvokeCommandAction Command="{Binding TextChangedCommand}"/>
        </i:EventTrigger>
    </i:Interaction.Triggers>
</RichTextBox>

    public DelegateCommand TextChangedCommand { get; }
private void OnTextChanged()
{
    Console.WriteLine("测试说明已更改");
}
  • 作用：
    • 响应文本变化。
(13) Selection
  • 功能：
    • 获取或设置选中的文本范围（通过 TextSelection 对象）。
  • 用法：
    • 使用代码操作选中文本。
  • 适用场景：
    • 高亮测试日志的关键部分。
  • 代码示例：
    <RichTextBox x:Name="LogRichTextBox"/>
<Button Content="高亮日志" Command="{Binding HighlightLogCommand}"/>

    public DelegateCommand HighlightLogCommand { get; }
private void HighlightLog()
{
    var range = new TextRange(LogRichTextBox.Document.ContentStart, LogRichTextBox.Document.ContentEnd);
    range.ApplyPropertyValue(TextElement.BackgroundProperty, Brushes.Yellow);
}
  • 作用：
    • 操作选中文本。
5. 滚动和布局相关属性
(14) HorizontalScrollBarVisibility 和 VerticalScrollBarVisibility
  • 功能：
    • 控制水平和垂直滚动条的可见性，可能的值：
      • Auto：根据内容自动显示（默认）。
      • Visible：始终显示。
      • Hidden：始终隐藏。
      • Disabled：禁用滚动。
  • 用法：
    • 设置滚动条行为以优化用户体验。
  • 适用场景：
    • 确保长日志可滚动。
  • 代码示例：
    <RichTextBox VerticalScrollBarVisibility="Auto"/>
  • 作用：
    • 控制滚动行为。
(15) Padding 和 Margin
  • 功能：
    • Padding：控制内容与边框的内边距。
    • Margin：控制控件与外部控件的外边距。
  • 用法：
    • 设置间距以优化布局。
  • 适用场景：
    • 调整测试说明区域的布局。
  • 代码示例：
    <RichTextBox Padding="5" Margin="5"/>
  • 作用：
    • 优化布局美观性。

三、在 ProjectEditView.xaml 中的应用

在 ProjectEditView.xaml 中，RichTextBox 可用于编辑测试说明、记录日志或显示通道详情。以下是具体应用场景：

1. 测试说明编辑
  • 场景：
    • 允许用户编辑测试条件的详细说明。
  • 示例：
    <RichTextBox>
    <FlowDocument>
        <Paragraph>
            <Run Text="{Binding ProjectModel.TestDescription}"/>
        </Paragraph>
    </FlowDocument>
    <i:Interaction.Triggers>
        <i:EventTrigger EventName="TextChanged">
            <i:InvokeCommandAction Command="{Binding TestDescriptionChangedCommand}"/>
        </i:EventTrigger>
    </i:Interaction.Triggers>
</RichTextBox>

    public DelegateCommand TestDescriptionChangedCommand { get; }
private void OnTestDescriptionChanged()
{
    var textRange = new TextRange(RichTextBox.Document.ContentStart, RichTextBox.Document.ContentEnd);
    ProjectModel.TestDescription = textRange.Text;
}
  • 作用：
    • 编辑测试说明。
2. 测试日志记录
  • 场景：
    • 记录测试过程中的格式化日志。
  • 示例：
    <RichTextBox IsReadOnly="True" VerticalScrollBarVisibility="Auto">
    <FlowDocument>
        <Paragraph>
            <Run Text="{Binding TestLog}"/>
        </Paragraph>
    </FlowDocument>
</RichTextBox>
<Button Content="添加日志" Command="{Binding AddLogCommand}"/>

    public DelegateCommand AddLogCommand { get; }
private string _testLog = "测试日志:\n";
public string TestLog
{
    get => _testLog;
    set => SetProperty(ref _testLog, value);
}

private void AddLog()
{
    TestLog += $"[{DateTime.Now}]: 测试进行中...\n";
}
  • 作用：
    • 显示测试日志。
3. 通道详情显示
  • 场景：
    • 显示选定通道的格式化信息。
  • 示例：
    <RichTextBox IsReadOnly="True">
    <FlowDocument>
        <Paragraph>
            <Run Text="通道 ID: " FontWeight="Bold"/>
            <Run Text="{Binding SelectedChannel.ChannelID}"/>
        </Paragraph>
        <Paragraph>
            <Run Text="状态: " FontWeight="Bold"/>
            <Run Text="{Binding SelectedChannel.IsActive, Converter={StaticResource BooleanToStatusConverter}}"/>
        </Paragraph>
    </FlowDocument>
</RichTextBox>

    public class BooleanToStatusConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return (value is bool && (bool)value) ? "启用" : "禁用";
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        throw new NotImplementedException();
    }
}
  • 作用：
    • 显示格式化通道信息。

四、适用场景

  1. 富文本编辑：
    • 编辑测试说明或注释。
  2. 日志记录：
    • 记录格式化的测试日志。
  3. 信息展示：
    • 显示通道或参数的富文本详情。
  4. 动态交互：
    • 实时更新或保存文本内容。

五、完整代码示例

以下是一个完整的 RichTextBox 示例，模拟 ProjectEditView.xaml 中编辑测试说明和显示测试日志的场景：

XAML
<UserControl x:Class="PowerCycling.Views.ProjectEditView"
             xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             xmlns:i="http://schemas.microsoft.com/xaml/behaviors"
             xmlns:converter="clr-namespace:PowerCycling.Converters">
    <UserControl.Resources>
        <converter:BooleanToVisibilityConverter x:Key="BooleanToVisibilityConverter"/>
        <Style x:Key="RichTextBoxStyle" TargetType="RichTextBox">
            <Setter Property="Background" Value="White"/>
            <Setter Property="BorderBrush" Value="Gray"/>
            <Setter Property="BorderThickness" Value="1"/>
            <Setter Property="Margin" Value="5"/>
            <Setter Property="VerticalScrollBarVisibility" Value="Auto"/>
        </Style>
    </UserControl.Resources>
    <Grid>
        <Grid.RowDefinitions>
            <RowDefinition Height="Auto"/>
            <RowDefinition Height="*"/>
            <RowDefinition Height="Auto"/>
        </Grid.RowDefinitions>
        <!-- 测试条件 -->
        <StackPanel Grid.Row="0">
            <CheckBox Content="TimeStopper" 
                      IsChecked="{Binding ProjectModel.ParamSetupModel.StopConditionModel.IsTimeStopper}"/>
            <DatePicker SelectedDate="{Binding ProjectModel.ParamSetupModel.StopConditionModel.StopDate}"
                        Visibility="{Binding ProjectModel.ParamSetupModel.StopConditionModel.IsTimeStopper, Converter={StaticResource BooleanToVisibilityConverter}}"/>
        </StackPanel>
        <!-- 通道列表 -->
        <ListView Grid.Row="1" 
                  ItemsSource="{Binding ProjectModel.ChannelList}" 
                  SelectedItem="{Binding SelectedChannel}">
            <ListView.View>
                <GridView>
                    <GridViewColumn Header="通道 ID" DisplayMemberBinding="{Binding ChannelID}"/>
                </GridView>
            </ListView.View>
        </ListView>
        <!-- 测试日志 -->
        <StackPanel Grid.Row="2">
            <RichTextBox Style="{StaticResource RichTextBoxStyle}" 
                         IsReadOnly="True" 
                         Height="100">
                <FlowDocument>
                    <Paragraph>
                        <Run Text="{Binding TestLog}"/>
                    </Paragraph>
                </FlowDocument>
            </RichTextBox>
            <Button Content="添加日志" Command="{Binding AddLogCommand}"/>
        </StackPanel>
    </Grid>
</UserControl>
ViewModel
using Prism.Commands;
using Prism.Mvvm;
using System;
using System.Collections.ObjectModel;

namespace PowerCycling
{
    public class ProjectEditViewModel : BindableBase
    {
        public ProjectModel ProjectModel { get; set; } = new ProjectModel
        {
            ParamSetupModel = new ParamSetupModel
            {
                StopConditionModel = new StopConditionModel
                {
                    IsTimeStopper = true,
                    StopDate = null
                }
            },
            ChannelList = new ObservableCollection<ChannelModel>
            {
                new ChannelModel { ChannelID = "CH1" },
                new ChannelModel { ChannelID = "CH2" }
            }
        };

        private ChannelModel _selectedChannel;
        public ChannelModel SelectedChannel
        {
            get => _selectedChannel;
            set => SetProperty(ref _selectedChannel, value);
        }

        private string _testLog = "测试日志:\n";
        public string TestLog
        {
            get => _testLog;
            set => SetProperty(ref _testLog, value);
        }

        public DelegateCommand AddLogCommand { get; }

        public ProjectEditViewModel()
        {
            AddLogCommand = new DelegateCommand(AddLog);
        }

        private void AddLog()
        {
            TestLog += $"[{DateTime.Now}]: 测试进行中...\n";
        }
    }

    public class ProjectModel
    {
        public ParamSetupModel ParamSetupModel { get; set; } = new ParamSetupModel();
        public ObservableCollection<ChannelModel> ChannelList { get; set; }
    }

    public class ParamSetupModel : BindableBase
    {
        public StopConditionModel StopConditionModel { get; set; } = new StopConditionModel();
    }

    public class StopConditionModel : BindableBase
    {
        private bool _isTimeStopper;
        public bool IsTimeStopper
        {
            get => _isTimeStopper;
            set => SetProperty(ref _isTimeStopper, value);
        }

        private DateTime? _stopDate;
        public DateTime? StopDate
        {
            get => _stopDate;
            set => SetProperty(ref _stopDate, value);
        }
    }

    public class ChannelModel
    {
        public string ChannelID { get; set; }
    }
}
Converter
using System;
using System.Windows;
using System.Windows.Data;

namespace PowerCycling.Converters
{
    public class BooleanToVisibilityConverter : IValueConverter
    {
        public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
        {
            return (value is bool && (bool)value) ? Visibility.Visible : Visibility.Collapsed;
        }

        public object ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture)
        {
            return value is Visibility visibility && visibility == Visibility.Visible;
        }
    }
}

六、优化建议

  1. 动态格式化：

    • 动态添加格式化日志：
      private void AddFormattedLog()
{
    var paragraph = new Paragraph();
    paragraph.Inlines.Add(new Run($"[{DateTime.Now}]: ") { FontWeight = FontWeights.Bold });
    paragraph.Inlines.Add(new Run("测试进行中...\n"));
    LogRichTextBox.Document.Blocks.Add(paragraph);
}

  2. 性能优化：

    • 限制日志大小以避免内存问题：
      private void AddLog()
{
    if (LogRichTextBox.Document.Blocks.Count > 100)
        LogRichTextBox.Document.Blocks.Clear();
    TestLog += $"[{DateTime.Now}]: 测试进行中...\n";
}

  3. 交互优化：

    • 添加工具栏支持格式化：
      <ToolBar>
    <Button Command="EditingCommands.ToggleBold" Content="粗体"/>
    <Button Command="EditingCommands.ToggleItalic" Content="斜体"/>
</ToolBar>
<RichTextBox/>

  4. 可访问性：

    • 添加工具提示：
      <RichTextBox ToolTip="测试日志区域"/>

七、总结

RichTextBox 是 WPF 中用于显示和编辑富文本的控件，适合在 ProjectEditView.xaml 中编辑测试说明、记录日志或显示通道详情。其核心属性（如 Document、IsReadOnly、TextChanged）支持灵活的文本操作，结合 MVVM 模式实现动态交互。上述示例展示了如何在参数配置场景中使用 RichTextBox，并提供了优化建议。如果需要进一步的实现细节、测试代码或特定场景的定制（如嵌入图像或保存 RTF 文件），请提供更多信息！

# wpf
Logo
乐奇 Rokid 开放社区

更多推荐

从对话到行动：用 AIUI 构建「喝水节奏教练」

「喝水节奏教练」是专为Rokid AI眼镜设计的本地化饮水记录智能体，通过自然语言指令实现“记一杯”“查进度”“撤销错误”等操作，数据全程本地存储。基于意图驱动的单页面UI，结合语音识别与A2UI动态渲染，支持快速记录、实时核对与修正，不依赖云端或健康数据，专注轻量可信的饮水节奏管理。

avatar 乐奇 Rokid 开放社区

智能眼镜市场全景解析：从技术演进到产业格局

本文系统梳理智能眼镜市场，涵盖产品形态、技术演进、市场规模、产业链结构及竞争格局。指出智能眼镜正从音频交互向AR显示与空间计算演进，受AI大模型、供应链成熟与生态延伸驱动，呈现分层发展态势。虽面临场景刚需不足、续航重量矛盾与隐私挑战，但B端应用先行、AI原生设计与标准完善将推动行业迈向规模化渗透，未来需关注核心技术突破与真实使用数据。

avatar 乐奇 Rokid 开放社区
cover

【日常逃跑计划：把世界戴在眼睛上，是什么体验？】

avatar 乐奇 Rokid 开放社区