技术总结:自动扩张WPF树型表格列宽

问题描述

    今天测试人员提了一个易用性的BUG,主要是说系统目前使用的树型控件不支持自动扩张列的宽度。其实客户那边已经对这个问题提了多次,不过由于对WPF只是入门级,所以一直都没改。这两天项目比较闲,就花了些时间把这个问题改了。原问题如下:

image 

图1 问题描述

 

背景

    树型控件在GIX4系统中已经被大量使用。这个控件是一年前其它同事在网上搜索到,再引入的。

    一开始的时候,要解决这个问题,想到的最直接的方案是这样的:找到第一列中的Expander控件(加号:image),然后监听它的“Expanded”事件;在事件处理程序中,计算所需要的宽度,然后设置为控件的宽度。

    按照这个方案去实际写代码时,发现并没有想象中那么简单,发现了很多问题。例如,Expander并不是Expander控件,而是一个ToggleButton,而且是写在模板中的,TreeGridRowPresenter中的Expander的类型也只是UIElement,也就是说,不能把Expander从UIElement转换为ToggleButton,这样程序会写得很死。又如,如何计算第一列的所需要宽度。

    虽然我们项目中是有整个控件的源码,但是整合进来后别的同事已经对它进行了很多修改,所以只有在网上找到最原始的源码来研究。发现,原来这个树型控件的方案是Avalon Team自己给出的:《TreeListView: Show Hierarchy Data with Details in Columns》。然后Ricciolo对它进行了一些研究:《Fun With GridView*RowPresenter》,最后他给出了一个较完整的版本:《A complete WPF TreeListView control》。

    学习并研究了它的源码,最后总结出以下几个子问题,这些问题是要上面提及的BUG所需要解决的:

 

四个待解决的问题

    1. 何时触发是最合适的?在何处触发调整宽度的代码?

    2. 如何找到树型控件的所有GridViewRowPresenter。

    3. GridViewRowPresenter中,如何把第一列的控件找到。

    4. 第一列控件的组成结构是怎么样的,它所需要的大小如何求出,是否可以直接使用Measure和DesiredSize。

 

一步一步解决

    第一个问题,何时触发这个功能?其实我是要在点击后,当子节点都加载好后,然后计算出合适的大小,再设置给列对象。我先在TreeListView的OnExpanded事件处理程序中尝试编写代码获取每一个TreeListView,但是发现这个事件在发生时,所有的子节点并没有生成,所以不能通过ItemContainerGenerator.GetContainerForItem方法获取到窗口,此方案失败。接着,我查看了ItemsControl的接口声明,发现ItemContainerGenerator属性有事件StatusChanged。所以我就改为监听这个事件,并判断如果当它的Status变为ContainersGenerated时,就表示所有子节点已经生成了。代码如下:

this.ItemContainerGenerator.StatusChanged += (o, e) =>
{
    if (this.ItemContainerGenerator.Status == GeneratorStatus.ContainersGenerated)
    {
        this.AdjustFirstColumnWidth();
    }
};

但是同样发现新的问题,这时候虽然窗口对象TreeListView已经生成,但是它下面的所有Visual Child都没有生成,这样同样无法获取到它里面用来显示每一行的GridRowPresenter。所以只有改成了这样:

public TreeListViewItem()
{
    this.PrepareToAdjustFirstColumnWidth();
}

private void PrepareToAdjustFirstColumnWidth()
{
    this.ItemContainerGenerator.StatusChanged += (o, e) =>
    {
        if (this.ItemContainerGenerator.Status == GeneratorStatus.ContainersGenerated)
        {
            if (this.Items.Count > 0)
            {
                var item = this.Items[this.Items.Count - 1];
                var treeItem = this.ItemContainerGenerator.ContainerFromItem(item) as TreeListViewItem;
                treeItem.Loaded += (oo, ee) =>
                {
                    this.AdjustFirstColumnWidth();
                };
            }
        }
    };
}

这样,最后一个孩子的可视内容都加载好后,才会触发调整宽度的代码。

    第二个问题比较简单,看了TreeListView的源码后,发现它在TreeListViewItem类的模板中使用了GridViewRowPresenter类,然后为它定义了名字:“PART_Header”。在模板中以PART_起头的控件是控件的约定,具体内容见:《WPF Parts Control Model》。所以我可以使用以下方法找到它,而不用考虑新的模板是否有它:

private TreeGridViewRowPresenter FindGridRow()
{
    var rowPresenter = this.Template.FindName("PART_Header", this) as TreeGridViewRowPresenter;
    return rowPresenter;
}

    要解决第三个问题,我们需要知道GridViewRowPresenter中如何生成一行,并知道最后生成的控件结构。先看看GridViewRowPresenter最后生成的控件结构,这里我使用的是Snoop:

image

图2 用Snoop查看TreeGridViewRowPresenter的可视化结构

我们发现,GridViewRowPresenter下只是简单的包含了几个可视元素,它们刚好是每一列所显示的内容。再查看GridViewRowPresenter的源代码,发现它拥有以下属性:public GridViewColumnCollection Columns{get;set;}、internal UIElementCollection InternalCollection{get;set;},进一步分析后,我猜测性地得出以下结论:GridViewRowPresenter.InternalCollection简单地包含了所有列的显示元素,它会根据Columns属性中各行对这些可视元素进行维护,让它们显示得跟表格一样。

至此,第三个问题解决了:

var firstColumn = VisualTreeHelper.GetChild(rowPresenter, 0) as UIElement;

    最后一个问题,是过程中最麻烦的一个问题。我们看到,图2中该行下的第一个元素是第一列的显示元素,显示了“2.1”。但是文本左边的Expander控件却是TreeGridViewRowPresenter的最后一个可视化孩子。而且缩进并不是一个控件。那么这是怎么一回事呢?看了TreeGridViewRowPresenter的源码后,发现原来是它主动把Expander放在了最后:

public class TreeGridViewRowPresenter : GridViewRowPresenter
{
    protected override System.Windows.Media.Visual GetVisualChild(int index)
    {
        // Last element is always the expander
        // called by render engine
        if (index < base.VisualChildrenCount) return base.GetVisualChild(index);
        if (index == base.VisualChildrenCount) return this.lbRowNo;
        return this.Expander;
    }

    protected override int VisualChildrenCount
    {
        get
        {
            // Last element is always the expander
            if (this.Expander != null)
                return base.VisualChildrenCount + 2;
            else
                return base.VisualChildrenCount + 1;
        }
    }
}
而文本前面先显示缩进,然后再显示Expander的原因是由于TreeGridViewRowPresenter类重写了FrameworkElement.ArrangeOverride方法。在该方法中,它把第一列的元素显示的长度变短,在之前显示一段缩进的空白和Expander控件:
protected override Size ArrangeOverride(Size arrangeSize)
{
    Size s = base.ArrangeOverride(arrangeSize);

    if (this.Columns == null || this.Columns.Count == 0) return s;
    UIElement expander = this.Expander;

    double current = 0;
    double max = arrangeSize.Width;
    for (int x = 0; x < this.Columns.Count; x++)
    {
        GridViewColumn column = this.Columns[x];
        // Actual index needed for column reorder
        UIElement uiColumn = (UIElement)base.GetVisualChild((int)ActualIndexProperty.GetValue(column, null));

        // Compute column width
        double w = Math.Min(max, (Double.IsNaN(column.Width)) ? (double)DesiredWidthProperty.GetValue(column, null) : column.Width);

        // First column indent
        if (x == 0 && expander != null)
        {
            double indent = FirstColumnIndent + expander.DesiredSize.Width;
            uiColumn.Arrange(new Rect(current + indent, 0, w - indent, arrangeSize.Height));
        }
        else
        {
            uiColumn.Arrange(new Rect(current, 0, w, arrangeSize.Height));
        }
        max -= w;
        current += w;
    }

    // Show expander
    if (expander != null)
    {
        expander.Arrange(new Rect(this.FirstColumnIndent, 0, expander.DesiredSize.Width, expander.DesiredSize.Height));
    }

    return s;
}

分析到这里,就知道如何计算出第一列的最终宽度了:

private double GetFirstColumnDesiredWidth()
{
    var rowPresenter = this.FindGridRow();
    if (VisualTreeHelper.GetChildrenCount(rowPresenter) <= 0) return 0;

    //GridViewRowPresenter中的每一个元素表示一列。
    var firstColumn = VisualTreeHelper.GetChild(rowPresenter, 0) as UIElement;
    var desiredWidth = firstColumn.DesiredSize.Width;

    //需要的宽度前,需要加上列的缩进和Expander的宽度。
    var indent = rowPresenter.FirstColumnIndent + rowPresenter.Expander.DesiredSize.Width;
    return indent + desiredWidth + ENSURE_SIZE;
}

加上以下这段代码后,程序终于可以正确运行了。

 

总结

    解决这个问题,花了一天多的时间,主要原因还是因为对WPF还是处在入门的级别。其中学到了以下内容:

熟悉了TreeView、TreeViewItem、ItemsControl的使用及树型控件的原理。

树型表格控件TreeListView的设计过程(见之前的文章)。

熟悉了Measure的使用。

posted @ 2010-08-05 17:58  BloodyAngel  阅读(4363)  评论(6编辑  收藏  举报