WPF模板中ContentPresenter在ToolTip内失效的问题排查与解决

原因分析 #

当你把<ContentPresenter/>放在ToolTip中时，由于ToolTip是独立于原控件可视化树的弹出元素，它的上下文不会自动继承模板所属控件的信息。未指定绑定的ContentPresenter默认会从自身DataContext获取内容，但此时DataContext并非模板的TemplatedParent（即使用该模板的控件），因此无法正确读取控件的Content属性，导致内容不显示。而静态文本是直接写死的固定内容，不需要依赖绑定，所以能正常显示。

修复方法 #

核心是让ContentPresenter正确关联到模板所属控件的Content属性，有两种常用实现方式：

方法1：直接绑定ContentPresenter的Content属性 #

给ContentPresenter明确指定Content绑定，指向模板的TemplatedParent的Content属性：

<ControlTemplate TargetType="Button">
    <Grid>
        <!-- 帮助图标视觉元素 -->
        <Ellipse Width="20" Height="20" Fill="LightBlue"/>
        <TextBlock Text="?" HorizontalAlignment="Center" VerticalAlignment="Center"/>
        <!-- 绑定到模板父控件的Content -->
        <ToolTip>
            <ContentPresenter Content="{Binding RelativeSource={RelativeSource TemplatedParent}, Path=Content}"/>
        </ToolTip>
    </Grid>
</ControlTemplate>

方法2：设置ToolTip的DataContext #

将ToolTip的DataContext绑定到模板的TemplatedParent，内部的ContentPresenter会自动继承该上下文并读取Content属性：

<ControlTemplate TargetType="Button">
    <Grid>
        <!-- 帮助图标视觉元素 -->
        <Ellipse Width="20" Height="20" Fill="LightBlue"/>
        <TextBlock Text="?" HorizontalAlignment="Center" VerticalAlignment="Center"/>
        <!-- 设置ToolTip的上下文为模板父控件 -->
        <ToolTip DataContext="{Binding RelativeSource={RelativeSource TemplatedParent}}">
            <ContentPresenter/>
        </ToolTip>
    </Grid>
</ControlTemplate>

使用示例 #

应用模板后，控件的Content会自动作为ToolTip内容显示：

<Button Template="{StaticResource HelpIconTemplate}">
    这是帮助提示的内容，鼠标悬停时会显示
</Button>

内容的提问来源于stack exchange，提问作者Daniel Müller