如何为WPF RichTextBox元素实现占位符/水印效果

你之前照搬TextBox的方案失效是三个核心问题导致的：

• RichTextBox 没有Text依赖属性，内容全存在Document属性里，之前绑定Text路径根本拿不到输入值，触发器完全不触发
• 你把占位提示的Run直接写在RichTextBox自身的FlowDocument里，用户输入时会和占位内容混在同一份文档里，没法做到输入即隐藏提示
• 流文档里的Run不在常规可视化树范围，用x:Reference查找外层命名元素会出现引用找不到的问题，触发器逻辑直接跑不通

可直接复用的实现（和你原有TextBox水印逻辑对齐） #

和你给TextBox做水印的思路完全一致：重写控件模板，分上下两层，上层放响应用户输入的RichTextBox，下层放显示占位提示的文本，通过判断文档是否为空、控件是否聚焦来控制提示的显隐，不需要改后台业务逻辑。
首先先写一个判断RichTextBox内容是否为空的转换器，因为没法直接绑定拿到纯文本内容：

public class RtbEmptyCheckConverter : IValueConverter
{
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        if (value is FlowDocument doc)
        {
            // 过滤掉默认的空段落、换行符，判断是否存在实际输入
            string plainText = new TextRange(doc.ContentStart, doc.ContentEnd).Text.Trim();
            return string.IsNullOrEmpty(plainText);
        }
        return true;
    }

    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        throw new NotImplementedException();
    }
}

然后在XAML资源里注册转换器，再写对应Style：

<!-- 注册转换器 -->
<local:RtbEmptyCheckConverter x:Key="RtbEmptyConverter"/>

<Style x:Key="RtbPlaceHolderStyle" TargetType="RichTextBox" BasedOn="{StaticResource {x:Type RichTextBox}}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="RichTextBox">
                <Grid>
                    <!-- 下层：占位提示文本 -->
                    <TextBlock x:Name="PlaceHolderTip"
                               Margin="15 0 15 0"
                               Foreground="LightGray"
                               Text="{TemplateBinding Tag}"
                               TextWrapping="Wrap"
                               VerticalAlignment="Top"/>
                    <!-- 上层：实际接收输入的RichTextBox，背景设为透明即可透出下层提示 -->
                    <RichTextBox x:Name="InputBox"
                                 Background="Transparent"
                                 BorderThickness="0"
                                 AcceptsReturn="True"
                                 TextWrapping="Wrap"
                                 Document="{TemplateBinding Document}"/>
                </Grid>
                <ControlTemplate.Triggers>
                    <!-- 检测到有输入内容时，隐藏占位提示 -->
                    <DataTrigger Binding="{Binding Document, ElementName=InputBox, Converter={StaticResource RtbEmptyConverter}}" Value="False">
                        <Setter TargetName="PlaceHolderTip" Property="Visibility" Value="Collapsed"/>
                    </DataTrigger>
                    <!-- 控件获得输入焦点时，隐藏占位提示 -->
                    <Trigger Property="IsKeyboardFocused" Value="True">
                        <Setter TargetName="PlaceHolderTip" Property="Visibility" Value="Collapsed"/>
                    </Trigger>
                    <!-- 原有printcontrol相关逻辑直接加在这里即可 -->
                    <DataTrigger Binding="{Binding printcontrol}" Value="True">
                        <Setter TargetName="PlaceHolderTip" Property="Visibility" Value="Hidden"/>
                    </DataTrigger>
                </ControlTemplate.Triggers>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

使用的时候直接给RichTextBox套用样式，把占位提示文字写在Tag属性里就行：

<RichTextBox Style="{StaticResource RtbPlaceHolderStyle}"
             Tag="请输入备注内容"/>

轻量替代方案 #

如果不想重写整个控件模板，可以通过附加属性实现：给RichTextBox注册一个占位文本的附加属性，在控件的TextChanged、GotFocus、LostFocus事件里判断当前内容，动态插入/移除占位提示段落即可，好处是不影响原有控件样式，坏处是需要额外处理光标逻辑，避免用户选中占位文本。

内容的提问来源于stack exchange，提问作者Dr.rektalius