自定义面板优化统计标题卡

Posted guanguanchangyu

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了自定义面板优化统计标题卡相关的知识,希望对你有一定的参考价值。

上篇文章WPF实现高仿统计标题卡中,实现了依据自己喜欢的统计卡片组件样式,实现过程中,发现,现有的WPF默认自带面板GridUniformGridStackPanelDockPanelWrapPanel以及Canvas等暂时没有满足条件的面板容器,接下来就是一个简单的容器面板我称之为BootstrapPanel,参考容器面板UniformGridWrapPanel两个容器的功能,项目仍然为上篇文章使用的项目为例

技术图片

基础面板分析

UniformGrid

提供功能

该容器面板能够依据内部的可视子级数量,在未设置RowsColumnsFirstColumn等属性的条件下,进行自动填充均分容器面板的各区域

<ItemsControl ItemsSource="{Binding Path=Data}" FocusVisualStyle="{x:Null}">
                <ItemsControl.ItemsPanel>
                    <ItemsPanelTemplate>
                        <UniformGrid></UniformGrid>
                    </ItemsPanelTemplate>
                </ItemsControl.ItemsPanel>
</ItemsControl>

技术图片

问题

当随着容器面板大小缩放时,容器内的布局并不能够根据容器大小做出相应调整(换行减列)

WrapPanel

提供功能

能够根据容器的大小,合理为容器内的各个可见元素做自适应处理(加列减行或减列加行)

<ItemsControl ItemsSource="{Binding Path=Data}" FocusVisualStyle="{x:Null}">
                <ItemsControl.ItemsPanel>
                    <ItemsPanelTemplate>
                        <WrapPanel></WrapPanel>
                    </ItemsPanelTemplate>
                </ItemsControl.ItemsPanel>
</ItemsControl>

技术图片

问题

虽然能够自动处理容器中元素的位置,但过于容器内的尺寸过于依赖已定尺寸,变换过程中,显示过程中,元素的尺寸无法自动填充容器的富余空间

思路分析

实际使用的过程中,我需要使用的容器需求归纳是如下几点:

  • 能够实现容器内元素均分(UniformGrid具备)
  • 能够在容器变化时,自动处理容器中的元素位置变化(WrapPanel具备)
  • 能够自动填充富余空间(UniformGrid具备)

编辑与实现

于是,开启源码的浏览过程,自定义项目,结构如下:

技术图片

测量容器、元素尺寸

此处忽略,菜鸟博主详细的探索细节,基本方向就是,通过看源码,重新构建上述两个容器的源码,通过源码最终决定以UniformGrid作为基础参照类,将动态设置元素布局的ArrangeOverride函数保留,能够保留元素动态适应容器布局,ps,可以直接挪用

protected override Size ArrangeOverride(Size arrangeSize)
        {
            Rect finalRect = new Rect(0.0, 0.0, arrangeSize.Width / (double)_columns, arrangeSize.Height / (double)_rows);
            double width = finalRect.Width;
            double num = arrangeSize.Width - 1.0;
            foreach (UIElement internalChild in base.InternalChildren)
            {
                internalChild.Arrange(finalRect);
                if (internalChild.Visibility != Visibility.Collapsed)
                {
                    finalRect.X += width;
                    if (finalRect.X >= num)
                    {
                        finalRect.Y += finalRect.Height;
                        finalRect.X = 0.0;
                    }
                }
            }
            return arrangeSize;
}

处理容器行列

主要需要考虑的是在测量也就是MeasureOverride函数对容器尺寸变更时,对行列的动态计算,我采用的方式,对列作处理,在不同条件下,显示不同的数据列,改变原有UniformGrid的固定行列方式,于是改动其中的UpdateComputedValues函数,将固定均分改为自定义实现逻辑,同时为了能够控制均分后,统一控制每个元素中的外边距,添加了一个依赖属性Gutter

Gutter依赖属性

        /// <summary>
        /// 元素之间的间距
        /// </summary>
        public Thickness Gutter
        {
            get { return (Thickness)GetValue(GutterProperty); }
            set { SetValue(GutterProperty, value); }
        }
        public static readonly DependencyProperty GutterProperty =
            DependencyProperty.Register("Gutter", typeof(Thickness), typeof(BootstrapPanel), new PropertyMetadata(new Thickness(0)));

UpdateComputedValues函数

        protected override Size MeasureOverride(Size constraint)
        {
            //自动获取行列数量
            UpdateComputedValues(constraint);

            //设置容器测量尺寸
            Size availableSize = new Size(constraint.Width / (double)_columns, constraint.Height / (double)_rows);
            double num = 0.0;
            double num2 = 0.0;
            int i = 0;
            for (int count = base.InternalChildren.Count; i < count; i++)
            {
                UIElement uIElement = base.InternalChildren[i];
                //Margin
                uIElement.SetValue(MarginProperty, Gutter);
                uIElement.Measure(availableSize);
                Size desiredSize = uIElement.DesiredSize;
                if (num < desiredSize.Width)
                {
                    num = desiredSize.Width;
                }
                if (num2 < desiredSize.Height)
                {
                    num2 = desiredSize.Height;
                }
            }
            return new Size(num * (double)_columns, num2 * (double)_rows);
        }

        /// <summary>
        /// 自动设置行列规则
        /// </summary>
        private void UpdateComputedValues(Size constraint)
        {
            //通过当前容器宽度以及默认最小宽度
            //获取到实际默认容器的列数
            if (DoubleUtil.IsNaN(ItemMinWidth))
            {
                throw new ArgumentNullException("请设置ItemMinWidth的目标值");
            }
            #region 统计容器中可见元素数量
            //统计未隐藏不占位的子级元素数量
            int childrenCount = 0;
            int i = 0;
            for (int count = base.InternalChildren.Count; i < count; i++)
            {
                UIElement uIElement = base.InternalChildren[i];
                if (uIElement.Visibility != Visibility.Collapsed)
                {
                    childrenCount++;
                }
            }
            if (childrenCount == 0)
            {
                childrenCount = 1;
            }
            #endregion

            //同行列数
            int colCount = (int)(constraint.Width / (ItemMinWidth + Gutter.Left + Gutter.Right));
            if (colCount >= childrenCount)//同行最大列数
            {
                _columns = childrenCount;
            }
            else if (colCount == 0)//容器宽度不能满足最小宽度
            {
                _columns = 1;
            }
            else
            {
                _columns = colCount;
            }
            if (_columns > 0)
            {
                _rows = (childrenCount + (_columns - 1)) / _columns;
                return;
            }
            //通过元素数量获取数据行数
            _rows = (int)Math.Sqrt(childrenCount);
            if (_rows * _rows < childrenCount)
            {
                _rows++;
            }
            if (_columns == 0)
            {
                _columns = (childrenCount + (_rows - 1)) / _rows;
            }
        }

容器代码

    /// <summary>
    /// 实现简单动态均分Panel容器
    /// </summary>
    public class BootstrapPanel : Panel
    {

        #region 依赖属性
        /// <summary>
        /// 子级最小宽度
        /// </summary>
        public double ItemMinWidth
        {
            get { return (double)GetValue(ItemMinWidthProperty); }
            set { SetValue(ItemMinWidthProperty, value); }
        }


        public static readonly DependencyProperty ItemMinWidthProperty = DependencyProperty.Register("ItemMinWidth", typeof(double), typeof(BootstrapPanel), new FrameworkPropertyMetadata(double.NaN, FrameworkPropertyMetadataOptions.AffectsMeasure), IsWidthHeightValid);
        private static bool IsWidthHeightValid(object value)
        {
            double num = (double)value;
            if (!DoubleUtil.IsNaN(num))
            {
                if (num >= 0.0)
                {
                    return !double.IsPositiveInfinity(num);
                }
                return false;
            }
            return true;
        }


        /// <summary>
        /// 元素之间的间距
        /// </summary>

        public Thickness Gutter
        {
            get { return (Thickness)GetValue(GutterProperty); }
            set { SetValue(GutterProperty, value); }
        }
        public static readonly DependencyProperty GutterProperty =
            DependencyProperty.Register("Gutter", typeof(Thickness), typeof(BootstrapPanel), new PropertyMetadata(new Thickness(0)));

        #endregion
        /// <summary>
        /// 实际行数
        /// </summary>
        private int _rows;
        /// <summary>
        /// 实际列数
        /// </summary>
        private int _columns;

        protected override Size MeasureOverride(Size constraint)
        {
            //自动获取行列数量
            UpdateComputedValues(constraint);

            //设置容器测量尺寸
            Size availableSize = new Size(constraint.Width / (double)_columns, constraint.Height / (double)_rows);
            double num = 0.0;
            double num2 = 0.0;
            int i = 0;
            for (int count = base.InternalChildren.Count; i < count; i++)
            {
                UIElement uIElement = base.InternalChildren[i];
                //Margin
                uIElement.SetValue(MarginProperty, Gutter);
                uIElement.Measure(availableSize);
                Size desiredSize = uIElement.DesiredSize;
                if (num < desiredSize.Width)
                {
                    num = desiredSize.Width;
                }
                if (num2 < desiredSize.Height)
                {
                    num2 = desiredSize.Height;
                }
            }
            return new Size(num * (double)_columns, num2 * (double)_rows);
        }

        /// <summary>
        /// 自动设置行列规则
        /// </summary>
        private void UpdateComputedValues(Size constraint)
        {
            //通过当前容器宽度以及默认最小宽度
            //获取到实际默认容器的列数
            if (DoubleUtil.IsNaN(ItemMinWidth))
            {
                throw new ArgumentNullException("请设置ItemMinWidth的目标值");
            }
            #region 统计容器中可见元素数量
            //统计未隐藏不占位的子级元素数量
            int childrenCount = 0;
            int i = 0;
            for (int count = base.InternalChildren.Count; i < count; i++)
            {
                UIElement uIElement = base.InternalChildren[i];
                if (uIElement.Visibility != Visibility.Collapsed)
                {
                    childrenCount++;
                }
            }
            if (childrenCount == 0)
            {
                childrenCount = 1;
            }
            #endregion

            //同行列数
            int colCount = (int)(constraint.Width / (ItemMinWidth + Gutter.Left + Gutter.Right));
            if (colCount >= childrenCount)//同行最大列数
            {
                _columns = childrenCount;
            }
            else if (colCount == 0)//容器宽度不能满足最小宽度
            {
                _columns = 1;
            }
            else
            {
                _columns = colCount;
            }
            if (_columns > 0)
            {
                _rows = (childrenCount + (_columns - 1)) / _columns;
                return;
            }
            //通过元素数量获取数据行数
            _rows = (int)Math.Sqrt(childrenCount);
            if (_rows * _rows < childrenCount)
            {
                _rows++;
            }
            if (_columns == 0)
            {
                _columns = (childrenCount + (_rows - 1)) / _rows;
            }
        }

        protected override Size ArrangeOverride(Size arrangeSize)
        {
            Rect finalRect = new Rect(0.0, 0.0, arrangeSize.Width / (double)_columns, arrangeSize.Height / (double)_rows);
            double width = finalRect.Width;
            double num = arrangeSize.Width - 1.0;
            foreach (UIElement internalChild in base.InternalChildren)
            {
                internalChild.Arrange(finalRect);
                if (internalChild.Visibility != Visibility.Collapsed)
                {
                    finalRect.X += width;
                    if (finalRect.X >= num)
                    {
                        finalRect.Y += finalRect.Height;
                        finalRect.X = 0.0;
                    }
                }
            }
            return arrangeSize;
        }
    }

容器使用

构造好的容器所在项目Bolg.AntPanel,被Blog.TotalCard项目引用,在页面中使用

命名空间引用

统计标题卡片对应的xaml中引入对应命名空间

xmlns:ant="clr-namespace:Blog.AntPanel.Controls;assembly=Blog.AntPanel"

组件中引用,替换掉之前的ItemControl对应的ItemsPanel,其中ItemMinWidth设置最小子级元素的宽度,Gutter设置子级元素间的外边距,主要作用到MeasureOverride中元素的属性设定

        protected override Size MeasureOverride(Size constraint)
        {
            //省略部分内容
            for (int count = base.InternalChildren.Count; i < count; i++)
            {
                //省略部分内容
                //Margin-设置元素外边距
                uIElement.SetValue(MarginProperty, Gutter);
                //省略部分内容
            }
            //省略部分内容
        }

xaml中使用

统计标题卡片对应的xamlItemsControl模板的使用

<ItemsControl.ItemsPanel>
    <ItemsPanelTemplate>
        <ant:BootstrapPanel ItemMinWidth="240" Gutter="10"></ant:BootstrapPanel>
    </ItemsPanelTemplate>
</ItemsControl.ItemsPanel>

运行效果

技术图片

实现功能

  • 能够根据容器中元素数量设定行列
  • 通过容器的尺寸变化变更元素排列
  • 元素均分的区域块元素自动填充

Q&A

如果需要项目源码,可以关注一下公众号,回复【BootstrapPanel】获取源码资源

技术图片

以上是关于自定义面板优化统计标题卡的主要内容,如果未能解决你的问题,请参考以下文章

如何在 SharePoint 2013 中创建自定义优化面板

为片段制作自定义列表视图?

使用删除与隐藏时未调用自定义动画

Android TabLayout ViewPager 不会在 backstack 上膨胀标签片段

PagerSlidingTabStrip- 使用列表片段的自定义视图显示突然的行为

n卡控制面板里的“优化以提高计算性能”有用吗