WPF 自定义 VirtualWrapPanel

这是一个关于如何实现WPF中的VirtualWrapPanel的详细教程,包括计算视图范围、定位子元素、虚拟化面板的测量和布局以及IScrollInfo接口的实现。代码示例展示了如何根据可用空间调整子项的排列并进行滚动操作。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

http://www.codeproject.com/Articles/64865/Enable-MultiSelect-in-WPF-ListView-2
using System;
using System.Collections.Specialized;
using System.Diagnostics;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Controls.Primitives;
using System.Windows.Media;

namespace QuickZip.UserControls
{
        public class VirtualWrapPanel : VirtualizingPanel, IScrollInfo, IChildInfo
        {
            public VirtualWrapPanel()
            {
                // For use in the IScrollInfo implementation
                this.RenderTransform = _trans;
            }

            #region Methods

            #region Layout specific code
            // I've isolated the layout specific code to this region. If you want to do something other than tiling, this is
            // where you'll make your changes

            /// <summary>
            /// Calculate the extent of the view based on the available size
            /// </summary>
            /// <param name="availableSize">available size</param>
            /// <param name="itemCount">number of data items</param>
            /// <returns></returns>
            private Size CalculateExtent(Size availableSize, int itemCount)
            {
                if (Orientation == Orientation.Horizontal)
                {
                    int childPerRow = CalculateChildrenPerRow(availableSize);
                    return new Size(childPerRow * this.ItemSize.Width,
                        this.ItemSize.Height * Math.Ceiling((double)itemCount / childPerRow));
                }
                else
                {
                    int childPerCol = CalculateChildrenPerCol(availableSize);
                    return new Size(this.ItemSize.Width * Math.Ceiling((double)itemCount / childPerCol),
                        childPerCol * this.ItemSize.Height);
                }
            }

            /// <summary>
            /// Get the range of children that are visible
            /// </summary>
            /// <param name="firstVisibleItemIndex">The item index of the first visible item</param>
            /// <param name="lastVisibleItemIndex">The item index of the last visible item</param>
            private void GetVisibleRange(out int firstVisibleItemIndex, out int lastVisibleItemIndex)
            {
                if (Orientation == Orientation.Horizontal)
                {
                    int childPerRow = CalculateChildrenPerRow(_extent);

                    firstVisibleItemIndex = (int)Math.Floor(_offset.Y / this.ItemSize.Height) * childPerRow;
                    lastVisibleItemIndex = (int)Math.Ceiling((_offset.Y + _viewport.Height) / this.ItemSize.Height) * childPerRow - 1;

                    ItemsControl itemsControl = ItemsControl.GetItemsOwner(this);
                    int itemCount = itemsControl.HasItems ? itemsControl.Items.Count : 0;
                    if (lastVisibleItemIndex >= itemCount)
                        lastVisibleItemIndex = itemCount - 1;
                }
                else
                {
                    int childPerCol = CalculateChildrenPerCol(_extent);

                    firstVisibleItemIndex = (int)Math.Floor(_offset.X / this.ItemSize.Width) * childPerCol;
                    lastVisibleItemIndex = (int)Math.Ceiling((_offset.X + _viewport.Width) / this.ItemSize.Width) * childPerCol - 1;

                    ItemsControl itemsControl = ItemsControl.GetItemsOwner(this);
                    int itemCount = itemsControl.HasItems ? itemsControl.Items.Count : 0;
                    if (lastVisibleItemIndex >= itemCount)
                        lastVisibleItemIndex = itemCount - 1;
                }

            }

            private Rect GetChildRect(int itemIndex, Size finalSize)
            {
                if (Orientation == Orientation.Horizontal)
                {
                    int childPerRow = CalculateChildrenPerRow(finalSize);

                    int row = itemIndex / childPerRow;
                    int column = itemIndex % childPerRow;

                    return new Rect(column * this.ItemSize.Width, row * this.ItemSize.Height, this.ItemSize.Width, this.ItemSize.Height);
                }
                else
                {
                    int childPerCol = CalculateChildrenPerCol(finalSize);

                    int column = itemIndex / childPerCol;
                    int row = itemIndex % childPerCol;

                    return new Rect(column * this.ItemSize.Width, row * this.ItemSize.Height, this.ItemSize.Width, this.ItemSize.Height);
                }
            }            

            /// <summary>
            /// Position a child
            /// </summary>
            /// <param name="itemIndex">The data item index of the child</param>
            /// <param name="child">The element to position</param>
            /// <param name="finalSize">The size of the panel</param>
            private void ArrangeChild(int itemIndex, UIElement child, Size finalSize)
            {
                child.Arrange(GetChildRect(itemIndex, finalSize));
            }

            /// <summary>
            /// Helper function for tiling layout
            /// </summary>
            /// <param name="availableSize">Size available</param>
            /// <returns></returns>
            private int CalculateChildrenPerRow(Size availableSize)
            {
                // Figure out how many children fit on each row
                int childrenPerRow;
                if (availableSize.Width == Double.PositiveInfinity)
                    childrenPerRow = this.Children.Count;
                else
                    childrenPerRow = Math.Max(1, (int)Math.Floor(availableSize.Width / this.ItemSize.Width));
                return childrenPerRow;
            }

            /// <summary>
            /// Helper function for tiling layout
            /// </summary>
            /// <param name="availableSize">Size available</param>
            /// <returns></returns>
            private int CalculateChildrenPerCol(Size availableSize)
            {
                // Figure out how many children fit on each row            
                if (availableSize.Height == Double.PositiveInfinity)
                    return this.Children.Count;
                else
                    return Math.Max(1, (int)Math.Floor(availableSize.Height / this.ItemSize.Height));
            }

            #endregion

            #region VirtualizingPanel
            /// <summary>
            /// Measure the children
            /// </summary>
            /// <param name="availableSize">Size available</param>
            /// <returns>Size desired</returns>
            protected override Size MeasureOverride(Size availableSize)
            {
                UpdateScrollInfo(availableSize);

                // Figure out range that's visible based on layout algorithm
                int firstVisibleItemIndex, lastVisibleItemIndex;
                GetVisibleRange(out firstVisibleItemIndex, out lastVisibleItemIndex);

                // We need to access InternalChildren before the generator to work around a bug
                UIElementCollection children = this.InternalChildren;
                IItemContainerGenerator generator = this.ItemContainerGenerator;

                // Get the generator position of the first visible data item
                GeneratorPosition startPos = generator.GeneratorPositionFromIndex(firstVisibleItemIndex);

                // Get index where we'd insert the child for this position. If the item is realized
                // (position.Offset == 0), it's just position.Index, otherwise we have to add one to
                // insert after the corresponding child
                int childIndex = (startPos.Offset == 0) ? startPos.Index : startPos.Index + 1;

                using (generator.StartAt(startPos, GeneratorDirection.Forward, true))
                {
                    for (int itemIndex = firstVisibleItemIndex; itemIndex <= lastVisibleItemIndex; ++itemIndex, ++childIndex)
                    {
                        bool newlyRealized;

                        // Get or create the child
                        UIElement child = generator.GenerateNext(out newlyRealized) as UIElement;
                        if (newlyRealized)
                        {
                            // Figure out if we need to insert the child at the end or somewhere in the middle
                            if (childIndex >= children.Count)
                            {
                                base.AddInternalChild(child);
                            }
                            else
                            {
                                base.InsertInternalChild(childIndex, child);
                            }
                            generator.PrepareItemContainer(child);
                        }
                        else
                        {
                            // The child has already been created, let's be sure it's in the right spot
                            Debug.Assert(child == children[childIndex], "Wrong child was generated");
                        }

                        // Measurements will depend on layout algorithm
                        child.Measure(ItemSize);
                    }
                }

                // Note: this could be deferred to idle time for efficiency
                CleanUpItems(firstVisibleItemIndex, lastVisibleItemIndex);

                return availableSize;
            }

            /// <summary>
            /// Arrange the children
            /// </summary>
            /// <param name="finalSize">Size available</param>
            /// <returns>Size used</returns>
            protected override Size ArrangeOverride(Size finalSize)
            {
                IItemContainerGenerator generator = this.ItemContainerGenerator;

                UpdateScrollInfo(finalSize);

                for (int i = 0; i < this.Children.Count; i++)
                {
                    UIElement child = this.Children[i];

                    // Map the child offset to an item offset
                    int itemIndex = generator.IndexFromGeneratorPosition(new GeneratorPosition(i, 0));

                    ArrangeChild(itemIndex, child, finalSize);
                }

                return finalSize;
            }

            /// <summary>
            /// Revirtualize items that are no longer visible
            /// </summary>
            /// <param name="minDesiredGenerated">first item index that should be visible</param>
            /// <param name="maxDesiredGenerated">last item index that should be visible</param>
            private void CleanUpItems(int minDesiredGenerated, int maxDesiredGenerated)
            {
                UIElementCollection children = this.InternalChildren;
                IItemContainerGenerator generator = this.ItemContainerGenerator;

                for (int i = children.Count - 1; i >= 0; i--)
                {
                    GeneratorPosition childGeneratorPos = new GeneratorPosition(i, 0);
                    int itemIndex = generator.IndexFromGeneratorPosition(childGeneratorPos);
                    if (itemIndex < minDesiredGenerated || itemIndex > maxDesiredGenerated)
                    {
                        generator.Remove(childGeneratorPos, 1);
                        RemoveInternalChildRange(i, 1);
                    }
                }
            }

            /// <summary>
            /// When items are removed, remove the corresponding UI if necessary
            /// </summary>
            /// <param name="sender"></param>
            /// <param name="args"></param>
            protected override void OnItemsChanged(object sender, ItemsChangedEventArgs args)
            {
                switch (args.Action)
                {
                    case NotifyCollectionChangedAction.Remove:
                    case NotifyCollectionChangedAction.Replace:
                    case NotifyCollectionChangedAction.Move:
                        RemoveInternalChildRange(args.Position.Index, args.ItemUICount);
                        break;
                }
            }
            #endregion

            #region IScrollInfo
            // See Ben Constable's series of posts at http://blogs.msdn.com/bencon/
            private void UpdateScrollInfo(Size availableSize)
            {
                // See how many items there are
                ItemsControl itemsControl = ItemsControl.GetItemsOwner(this);
                int itemCount = itemsControl.HasItems ? itemsControl.Items.Count : 0;

                Size extent = CalculateExtent(availableSize, itemCount);
                // Update extent
                if (extent != _extent)
                {
                    _extent = extent;
                    if (_owner != null)
                        _owner.InvalidateScrollInfo();
                }

                // Update viewport
                if (availableSize != _viewport)
                {
                    _viewport = availableSize;
                    if (_owner != null)
                        _owner.InvalidateScrollInfo();
                }
            }

            public ScrollViewer ScrollOwner
            {
                get { return _owner; }
                set { _owner = value; }
            }

            public bool CanHorizontallyScroll
            {
                get { return _canHScroll; }
                set { _canHScroll = value; }
            }

            public bool CanVerticallyScroll
            {
                get { return _canVScroll; }
                set { _canVScroll = value; }
            }

            public double HorizontalOffset
            {
                get { return _offset.X; }
            }

            public double VerticalOffset
            {
                get { return _offset.Y; }
            }

            public double ExtentHeight
            {
                get { return _extent.Height; }
            }

            public double ExtentWidth
            {
                get { return _extent.Width; }
            }

            public double ViewportHeight
            {
                get { return _viewport.Height; }
            }

            public double ViewportWidth
            {
                get { return _viewport.Width; }
            }

            public void LineUp()
            {
                SetVerticalOffset(this.VerticalOffset - 10);
            }

            public void LineDown()
            {
                SetVerticalOffset(this.VerticalOffset + 10);
            }

            public void PageUp()
            {
                SetVerticalOffset(this.VerticalOffset - _viewport.Height);
            }

            public void PageDown()
            {
                SetVerticalOffset(this.VerticalOffset + _viewport.Height);
            }

            public void MouseWheelUp()
            {
                SetVerticalOffset(this.VerticalOffset - 10);
            }

            public void MouseWheelDown()
            {
                SetVerticalOffset(this.VerticalOffset + 10);
            }

            public void LineLeft()
            {
                SetHorizontalOffset(this.HorizontalOffset - 10);
            }

            public void LineRight()
            {
                SetHorizontalOffset(this.HorizontalOffset + 10);
            }

            public Rect MakeVisible(Visual visual, Rect rectangle)
            {
                return new Rect();
            }

            public void MouseWheelLeft()
            {
                SetHorizontalOffset(this.HorizontalOffset - 10);
            }

            public void MouseWheelRight()
            {
                SetHorizontalOffset(this.HorizontalOffset + 10);
            }

            public void PageLeft()
            {
                SetHorizontalOffset(this.HorizontalOffset - _viewport.Width);
            }

            public void PageRight()
            {
                SetHorizontalOffset(this.HorizontalOffset + _viewport.Width);
            }

            public void SetHorizontalOffset(double offset)
            {
                if (offset < 0 || _viewport.Width >= _extent.Width)
                {
                    offset = 0;
                }
                else
                {
                    if (offset + _viewport.Width >= _extent.Width)
                    {
                        offset = _extent.Width - _viewport.Width;
                    }
                }

                _offset.X = offset;

                if (_owner != null)
                    _owner.InvalidateScrollInfo();

                _trans.X = -offset;

                // Force us to realize the correct children
                InvalidateMeasure();
            }

            public void SetVerticalOffset(double offset)
            {
                if (offset < 0 || _viewport.Height >= _extent.Height)
                {
                    offset = 0;
                }
                else
                {
                    if (offset + _viewport.Height >= _extent.Height)
                    {
                        offset = _extent.Height - _viewport.Height;
                    }
                }

                _offset.Y = offset;

                if (_owner != null)
                    _owner.InvalidateScrollInfo();

                _trans.Y = -offset;

                // Force us to realize the correct children
                InvalidateMeasure();
            }
            #endregion

            #region IChildInfo

            public Rect GetChildRect(int itemIndex)
            {
                return GetChildRect(itemIndex, _extent);
            }

            #endregion

            #endregion


            #region Data
            private TranslateTransform _trans = new TranslateTransform();
            private ScrollViewer _owner;
            private bool _canHScroll = false;
            private bool _canVScroll = false;
            private Size _extent = new Size(0, 0);
            private Size _viewport = new Size(0, 0);
            private Point _offset;
            #endregion

            #region Public Properties

            public static readonly DependencyProperty ItemWidthProperty
               = DependencyProperty.RegisterAttached("ItemWidth", typeof(double), typeof(VirtualWrapPanel),
                  new FrameworkPropertyMetadata(200.0d, FrameworkPropertyMetadataOptions.AffectsMeasure |
                  FrameworkPropertyMetadataOptions.AffectsArrange));

            // Accessor for the child size dependency property
            public double ItemWidth
            {
                get { return (double)GetValue(ItemWidthProperty); }
                set { SetValue(ItemWidthProperty, value); }
            }

            public static readonly DependencyProperty ItemHeightProperty
               = DependencyProperty.RegisterAttached("ItemHeight", typeof(double), typeof(VirtualWrapPanel),
                  new FrameworkPropertyMetadata(200.0d, FrameworkPropertyMetadataOptions.AffectsMeasure |
                  FrameworkPropertyMetadataOptions.AffectsArrange));

            // Accessor for the child size dependency property
            public double ItemHeight
            {
                get { return (double)GetValue(ItemHeightProperty); }
                set { SetValue(ItemHeightProperty, value); }
            }

            public Size ItemSize
            { get { return new Size(ItemWidth, ItemHeight); } }

            public static readonly DependencyProperty OrientationProperty
               = DependencyProperty.RegisterAttached("Orientation", typeof(Orientation), typeof(VirtualWrapPanel),
                  new FrameworkPropertyMetadata(Orientation.Horizontal, FrameworkPropertyMetadataOptions.AffectsMeasure |
                  FrameworkPropertyMetadataOptions.AffectsArrange));

            public Orientation Orientation
            {
                get { return (Orientation)GetValue(OrientationProperty); }
                set { SetValue(OrientationProperty, value); }
            }

            #endregion
        }
}

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值