原文:

1. 前言

HeaderedContentControl是WPF中就存在的控件，这个控件的功能很简单：提供Header和Content两个属性，在UI上创建两个ContentPresenter并分别绑定到Header和Content，让这两个ContentPresenter合体组成HeaderedContentControl。

2. 以前的问题

在WPF中，HeaderedContentControl是Expander、GroupBox、TabItem等诸多拥有Header属性的控件的基类，虽然很少直接用这个控件，它的存在也有一定价值。不过在WPF中它的价值也仅此而已，由开发者自己实现也极其容易，以至于后来在Silverlight中就没有提供这个控件（后来放到了Silverlight Toolkit这个扩展里）。

UWP中几乎所有的表单控件都有Header属性，如TextBox、ComboBox等，这么看起来HeaderedContentControl更加重要了，但UWP反而没有提供HeaderedContentControl这个控件。每个有Header属性的控件都既没有继承HeaderedContentControl，也没有使用HeaderedContentControl作为外层容器包装自己的内容，而是全都单独实现这个属性。其实这也可以理解，毕竟不是所有控件都是ContentControl，而且使用HeaderedContentControl作为外层容器会导致VisualTree多了一层，变得复杂而且影响性能。其实现在很少会有一个页面出现十分多表单控件的情况，这点性能损失我是不介意的。

UWP CommunityToolkit中也有一些控件包含Header属性，如HeaderedTextBlock和Expander，CommunityToolkit也没有为它们创建一个HeaderedContentControl，而且和TextBox等控件不同，UWP CommunityToolkit中的Header属性都是string类型，真是任性。

GitHub上也有过添加HeaderedContentControl的，其实我是很支持这件事的，毕竟HeaderedContentControl可不只是多了一个Header属性而已。可是微软一直拖到 发布才终于肯提供这个控件。

3. 现在的问题

虽然终于~终于等到了HeaderedContentControl，但让人高兴不起来，而且现在连HeaderedTextBlock和Expander都不使用这个HeaderedContentControl。微软第一次在UWP提供了HeaderedContentControl，有了一个Object类型的Header属性，两件事本应该为开发者提供更多的方便，但是，为什么会变成这样呢。

刚开始，HeaderedContentControl的Default Style是这样的：

真是让人扫兴。

毕竟这是照抄WPF的，也不能说它不对，但同样地这就把WPF的遗留问题完全保留下来了：因为使用了StackPanel，所以VerticalContentAlignment无论怎么设置都是无效的，Content都是直接趴在Header下面，两个ContentPresenter总是腻在一起：

这样的合体姿势明显不对，事实上在WPF中继承HeaderedContentControl的控件（如Expander和GroupBox）都在ControlTempalte中使用了Grid或DockPanel，而不是StackPanel，HeaderedContentControl使用StackPanel本身就是个错误。好在UWP CommunityToolkit

2.1正式添加HeaderedContentControl时Default Style修改为了使用Grid，总算解决了这个历史遗留问题：

另一个问题是Header与Content之间的Margin。仔细观察就会发现TextBox等控件的Header是有一个0,0,0,8的Margin，可是HeaderedContentControl并没有这样设置，结果HeaderedContentControl就会出现高度不匹配的问题：

        
         …
    
        
             
          
         …
    

不仅如此，TextBox在Disabled状态下Header会变成灰色，但HeaderedContentControl明显漏了这个VisualState，结果如下图所示，这个如果也要自己实现就很麻烦了。

以前微软迟迟不肯提供HeaderedContentControl，现在一出手就是半成品，我很怀疑微软这样做是为了考验我们这些还在坚持UWP的纯真开发者。

4. 自己实现有一个HeaderedContentControl

与其留着这个半成品祸害自己的代码，还不如干脆动手实现一个HeaderedContentControl。在以前已写过一次的文章，但那篇主要是为了讲解模板化控件，没有完整的功能。这次要做得完善些。

4.1 基本外观

包含Header和HeaderTemplate这两个属性和CommunityToolkit中的HeaderedContentControl一样，ControlTemplate中使用了Grid作为容器这点也一样，改变的主要有以下几点：

• Margin、ContentTransitions等属性有按照标准做法好好做了绑定。
• HorizontalContentAlignment和VerticalContentAlignment也从Left和Top改为Stretch，毕竟很多时候使用ContentPresenter 都要把这两个属性改为Stretch，还不如一开始就这样做。
• 别忘了IsTabStop要设置为False，这点以前在里有介绍过原因，这里不再赘述。

4.2 Disabled状态

protected virtual void UpdateVisualState(bool useTransitions){    VisualStateManager.GoToState(this, IsEnabled ? NormalName : DisabledName, useTransitions);}

ControlTemplate中需要包办Disabled状态，HeaderedContentControl中订阅自身的IsEnabledChanged事件，根据IsEnabled的值转换状态。

4.3 隐藏HeaderContentPresenter

private void UpdateVisibility(){    if (_headerContentPresenter != null)        _headerContentPresenter.Visibility = _headerContentPresenter.Content == null ? Visibility.Collapsed : Visibility.Visible;}

在OnApplyTemplate()和OnHeaderChanged(object oldValue, object newValue)函数中调用UpdateVisibility()以决定HeaderContentPresenter是否显示。这个功能，以及HeaderContentPresenter的Margin，HeaderedTextBlock都是有的，但偏偏就没做到隔壁的HeaderedContentControl，真是够了。

4.4 处理HeaderContentPresenter的点击事件

protected override void OnApplyTemplate(){    base.OnApplyTemplate();    _headerContentPresenter = GetTemplateChild(HeaderContentPresenterName) as ContentPresenter;    UpdateVisibility();    UpdateVisualState(false);    if (_headerContentPresenter != null)    {        _headerContentPresenter.PointerReleased += OnHeaderContentPresenterPointerReleased;        _headerContentPresenter.PointerPressed += OnHeaderContentPresenterPointerPressed1;    }}private void OnHeaderContentPresenterPointerPressed1(object sender, PointerRoutedEventArgs e){    if (Content is Control control)        control.Focus(FocusState.Programmatic);}private void OnHeaderContentPresenterPointerReleased(object sender, PointerRoutedEventArgs e){    e.Handled = true;}

在TextBox上点击它的Header，输入框将会获得焦点，上述代码就是实现这个功能。

这个功能我不是十分确定，至少目前看来这个行为是正确的。

5. 结语

HeaderedContentControl 明明只是个很简单的控件，明明只是个很简单的控件，明明只是个很简单的控件。

附上完整的代码：

[TemplateVisualState(Name = NormalName, GroupName = CommonStatesName)][TemplateVisualState(Name = DisabledName, GroupName = CommonStatesName)][TemplatePart(Name = HeaderContentPresenterName, Type = typeof(ContentPresenter))]public class HeaderedContentControl : ContentControl{    private const string CommonStatesName = "CommonStates";    private const string NormalName = "Normal";    private const string DisabledName = "Disabled";    private const string HeaderContentPresenterName = "HeaderContentPresenter";    /// 
    ///     标识 Header 依赖属性。    /// 
    public static readonly DependencyProperty HeaderProperty =        DependencyProperty.Register("Header", typeof(object), typeof(HeaderedContentControl), new PropertyMetadata(null, OnHeaderChanged));    /// 
    ///     标识 HeaderTemplate 依赖属性。    /// 
    public static readonly DependencyProperty HeaderTemplateProperty =        DependencyProperty.Register("HeaderTemplate", typeof(DataTemplate), typeof(HeaderedContentControl), new PropertyMetadata(null, OnHeaderTemplateChanged));    private ContentPresenter _headerContentPresenter;    public HeaderedContentControl()    {        DefaultStyleKey = typeof(HeaderedContentControl);        IsEnabledChanged += OnPickerIsEnabledChanged;    }    /// 
    ///     获取或设置Header的值    /// 
    public object Header    {        get => GetValue(HeaderProperty);        set => SetValue(HeaderProperty, value);    }    /// 
    ///     获取或设置HeaderTemplate的值    /// 
    public DataTemplate HeaderTemplate    {        get => (DataTemplate) GetValue(HeaderTemplateProperty);        set => SetValue(HeaderTemplateProperty, value);    }    private static void OnHeaderChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)    {        var target = obj as HeaderedContentControl;        var oldValue = args.OldValue;        var newValue = args.NewValue;        if (oldValue != newValue)            target.OnHeaderChanged(oldValue, newValue);    }    private static void OnHeaderTemplateChanged(DependencyObject obj, DependencyPropertyChangedEventArgs args)    {        var target = obj as HeaderedContentControl;        var oldValue = (DataTemplate) args.OldValue;        var newValue = (DataTemplate) args.NewValue;        if (oldValue != newValue)            target.OnHeaderTemplateChanged(oldValue, newValue);    }    protected override void OnApplyTemplate()    {        base.OnApplyTemplate();        _headerContentPresenter = GetTemplateChild(HeaderContentPresenterName) as ContentPresenter;        UpdateVisibility();        UpdateVisualState(false);        if (_headerContentPresenter != null)        {            _headerContentPresenter.PointerReleased += OnHeaderContentPresenterPointerReleased;            _headerContentPresenter.PointerPressed += OnHeaderContentPresenterPointerPressed1;        }    }    protected virtual void OnHeaderChanged(object oldValue, object newValue)    {        UpdateVisibility();    }    protected virtual void OnHeaderTemplateChanged(DataTemplate oldValue, DataTemplate newValue)    {    }    protected virtual void UpdateVisualState(bool useTransitions)    {        VisualStateManager.GoToState(this, IsEnabled ? NormalName : DisabledName, useTransitions);    }    private void UpdateVisibility()    {        if (_headerContentPresenter != null)            _headerContentPresenter.Visibility = _headerContentPresenter.Content == null ? Visibility.Collapsed : Visibility.Visible;    }    private void OnPickerIsEnabledChanged(object sender, DependencyPropertyChangedEventArgs e)    {        UpdateVisualState(true);    }    private void OnHeaderContentPresenterPointerPressed1(object sender, PointerRoutedEventArgs e)    {        if (Content is Control control)            control.Focus(FocusState.Programmatic);    }    private void OnHeaderContentPresenterPointerReleased(object sender, PointerRoutedEventArgs e)    {        e.Handled = true;    }}

6. 参考

7. 源码