使用自定义 WPF 控件时无法设置某些属性

Unable to set some properties when using custom WPF Control

所以,我有一个名为 WatermarkTextbox 的自定义 WPF 控件,它扩展了 TextBox。我唯一添加到代码中的是一个字符串依赖项 属性 来保存水印文本。其余的魔法在 Xaml(下)中。

<Style TargetType="wpfControls:WatermarkTextbox" >
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type wpfControls:WatermarkTextbox}">
                <Grid>
                    <TextBox x:Name="baseTextBox" />
                    <TextBlock Margin="5,0,0,0" x:Name="watermarkText" IsHitTestVisible="False" FontWeight="Light" FontStyle="Italic" Foreground="DarkGray" Visibility="Hidden" Background="Transparent"
                               Text="{Binding RelativeSource={RelativeSource AncestorType=wpfControls:WatermarkTextbox}, Path=Watermark}" />
                </Grid>
                <ControlTemplate.Triggers>
                    <Trigger SourceName="baseTextBox" Property="Text" Value="">
                        <Setter TargetName="watermarkText" Property="Visibility" Value="Visible"/>
                    </Trigger>
                </ControlTemplate.Triggers>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

并且在我的应用程序中使用时:

<wpfControls:WatermarkTextbox Watermark="Text that disappears."/>

这在大多数情况下都有效。我可以设置水印文本,当我开始输入一些文本时,它就会消失。当我更改字体大小时,它会同时更改水印和我输入的文本;当我改变字体粗细时,它只会改变输入的文本(这是我想要它做的)。我可以更改文本框的大小。这都是肉汁。

问题是当我开始尝试更改文本框的背景或边框属性时,就像这样。

<wpfControls:WatermarkTextbox Watermark="Text that disappears." Background="Yellow"/>

没有任何反应。 BorderBrush 和 BorderThickness 的行为相同。现在,我所知道的部分足以知道有一些我不知道的重要概念。如果我将 WatermarkTextbox 的模板更改为以下内容,它将允许我在我的应用程序中设置我想要的背景。

<Style TargetType="wpfControls:WatermarkTextbox" >
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type wpfControls:WatermarkTextbox}">
                <Grid>
                    <TextBox x:Name="baseTextBox" 
                             Background="{TemplateBinding Background}"/>
                    <TextBlock Margin="5,0,0,0" x:Name="watermarkText" IsHitTestVisible="False" FontWeight="Light" FontStyle="Italic" Foreground="DarkGray"
                               Text="{Binding RelativeSource={RelativeSource AncestorType=wpfControls:WatermarkTextbox}, Path=Watermark}" Visibility="Hidden" Background="Transparent"/>
                </Grid>
                <ControlTemplate.Triggers>
                    <Trigger SourceName="baseTextBox" Property="Text" Value="">
                        <Setter TargetName="watermarkText" Property="Visibility" Value="Visible"/>
                    </Trigger>
                </ControlTemplate.Triggers>
            </ControlTemplate>
        </Setter.Value>
    </Setter>
</Style>

我假设如果我对 BorderBrush 和 BorderThickness 做同样的事情,它们也会起作用。

所以,我的问题是,为什么?是什么使这些属性的行为不同于 FontSize 和 FontWeight 或 Height 和 Width?为什么我必须将背景显式设置为 {TemplateBinding Background} 而不是 FontSize?另外,我还需要为 TemplateBinding 设置哪些其他属性才能使其正常工作?

任何其他事情,您需要明确地做 TemplateBinding 事情——或者如果它们会在运行时改变,您将需要做一个相对源绑定:

{Binding PropertyName, RelativeSource={RelativeSource TemplatedParent}}

对此没有任何"first principles"解释;这只是任意的实现细节。

一些属性是自动从它们的父级继承的。 explanation

这就是您不必设置 FontSize 的原因。

至于"what else",这完全取决于您希望能够直接在用户控件上设置什么。

虽然这不是防弹的,但我的一般经验法则是 "if it is a property in the Brush Tab of the property window or is purely for visual aesthetics, it probably is not inherited"

另一种看待它的方式 - 如果设置通常会产生奇怪的结果,它也可能不是继承的。示例:如果您在 Grid 上设置 Margin 属性,想象一下是否每个子元素都继承了相同的边距。

所以我通常为所有非布局、视觉属性添加模板绑定 (Background, Foreground, BorderBrush, etc.)。或者我只是为我想直接设置到我的用户控件的任何属性添加模板绑定。如果您从未打算设置 属性(显式或按样式),则无需添加模板绑定。