405 lines
16 KiB
C#
405 lines
16 KiB
C#
using System.Windows.Markup;
|
||
|
||
namespace Melskin.Layout;
|
||
|
||
/// <summary>
|
||
/// WrapPanel 是一种布局面板，它允许子元素根据指定的方向（水平或垂直）自动换行排列。
|
||
/// 该面板提供了一种灵活的方式来控制子元素的宽度、高度以及它们之间的间距。
|
||
/// </summary>
|
||
/// <remarks>
|
||
/// 通过设置 Orientation 属性，可以指定子元素的排列方向是水平还是垂直。
|
||
/// ItemWidth 和 ItemHeight 属性用于统一设置所有子元素的宽度和高度。
|
||
/// 如果不需要统一设置，则可以忽略这两个属性，每个子元素将根据其自身的内容大小进行布局。
|
||
/// VerticalSpacing 和 HorizontalSpacing 属性分别定义了垂直和水平方向上相邻子元素间的间距。
|
||
/// </remarks>
|
||
[ContentProperty(nameof(Children))]
|
||
public class WrapPanel : Panel
|
||
{
|
||
/// <summary>
|
||
/// 表示WrapPanel中子元素的排列方向属性。通过设置此属性，可以控制子元素是水平排列还是垂直排列。
|
||
/// </summary>
|
||
public static readonly DependencyProperty OrientationProperty =
|
||
DependencyProperty.Register(nameof(Orientation), typeof(Orientation), typeof(WrapPanel), new FrameworkPropertyMetadata(Orientation.Horizontal, FrameworkPropertyMetadataOptions.AffectsMeasure));
|
||
|
||
/// <summary>
|
||
/// 表示WrapPanel中子元素的排列方向属性。通过设置此属性，可以控制子元素是水平排列还是垂直排列。
|
||
/// </summary>
|
||
public Orientation Orientation
|
||
{
|
||
get => (Orientation)GetValue(OrientationProperty);
|
||
set => SetValue(OrientationProperty, value);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 表示WrapPanel中所有子元素的统一宽度属性。通过设置此属性，可以为面板中的所有子元素指定相同的宽度。
|
||
/// </summary>
|
||
public static readonly DependencyProperty ItemWidthProperty =
|
||
DependencyProperty.Register(nameof(ItemWidth), typeof(double), typeof(WrapPanel), new FrameworkPropertyMetadata(double.NaN, FrameworkPropertyMetadataOptions.AffectsMeasure));
|
||
|
||
/// <summary>
|
||
/// 表示WrapPanel中每个子元素的宽度。通过设置此属性，可以统一控制面板内所有子元素的宽度。如果设置了该值，则所有子元素将具有相同的宽度；若未设置（即保持默认值NaN），则每个子元素将根据其自身内容确定宽度。
|
||
/// </summary>
|
||
public double ItemWidth
|
||
{
|
||
get => (double)GetValue(ItemWidthProperty);
|
||
set => SetValue(ItemWidthProperty, value);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 表示WrapPanel中所有子元素的统一高度属性。通过设置此属性，可以控制面板内所有子元素的高度一致。
|
||
/// 如果不需要统一设置，则可以忽略此属性，每个子元素将根据其自身的内容大小进行布局。
|
||
/// </summary>
|
||
public static readonly DependencyProperty ItemHeightProperty =
|
||
DependencyProperty.Register(nameof(ItemHeight), typeof(double), typeof(WrapPanel), new FrameworkPropertyMetadata(double.NaN, FrameworkPropertyMetadataOptions.AffectsMeasure));
|
||
|
||
/// <summary>
|
||
/// 表示WrapPanel中每个子元素的高度属性。通过设置此属性，可以统一控制所有子元素的高度。
|
||
/// 如果未设置或设置为NaN，则子元素将使用其自身的高度。
|
||
/// </summary>
|
||
public double ItemHeight
|
||
{
|
||
get => (double)GetValue(ItemHeightProperty);
|
||
set => SetValue(ItemHeightProperty, value);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 表示垂直方向上相邻子元素之间的间距属性。通过设置此属性，可以控制WrapPanel中垂直排列的子元素间的距离。
|
||
/// </summary>
|
||
public static readonly DependencyProperty VerticalSpacingProperty =
|
||
DependencyProperty.Register(nameof(VerticalSpacing), typeof(double), typeof(WrapPanel), new FrameworkPropertyMetadata(0d, FrameworkPropertyMetadataOptions.AffectsMeasure));
|
||
|
||
/// <summary>
|
||
/// 表示WrapPanel中子元素之间的垂直间距属性。通过设置此属性，可以控制子元素在垂直方向上的间距大小。
|
||
/// </summary>
|
||
public double VerticalSpacing
|
||
{
|
||
get => (double)GetValue(VerticalSpacingProperty);
|
||
set => SetValue(VerticalSpacingProperty, value);
|
||
}
|
||
|
||
/// <summary>
|
||
/// 表示WrapPanel中子元素在水平方向上的间距属性。通过设置此属性，可以控制相邻子元素之间的水平间距。
|
||
/// </summary>
|
||
public static readonly DependencyProperty HorizontalSpacingProperty =
|
||
DependencyProperty.Register(nameof(HorizontalSpacing), typeof(double), typeof(WrapPanel), new FrameworkPropertyMetadata(0d, FrameworkPropertyMetadataOptions.AffectsMeasure));
|
||
|
||
/// <summary>
|
||
/// 表示WrapPanel中子元素在水平方向上的间距属性。通过设置此属性，可以控制子元素之间的水平距离。
|
||
/// </summary>
|
||
public double HorizontalSpacing
|
||
{
|
||
get => (double)GetValue(HorizontalSpacingProperty);
|
||
set => SetValue(HorizontalSpacingProperty, value);
|
||
}
|
||
|
||
/// <inheritdoc />
|
||
protected override Size MeasureOverride(Size availableSize)
|
||
{
|
||
var itemWidth = ItemWidth;
|
||
var itemHeight = ItemHeight;
|
||
var verticalSpacing = VerticalSpacing;
|
||
var horizontalSpacing = HorizontalSpacing;
|
||
|
||
var offsetX = 0d;
|
||
var offsetY = 0d;
|
||
var maxLineLength = 0d;
|
||
var currentLineSize = 0d;
|
||
double currentLineLength;
|
||
|
||
Func<Size, double> childWidthGetter = double.IsNaN(itemWidth) ? size => size.Width : _ => itemWidth;
|
||
Func<Size, double> childHeightGetter = double.IsNaN(itemHeight) ? size => size.Height : _ => itemHeight;
|
||
|
||
var internalChildren = InternalChildren;
|
||
if (Orientation == Orientation.Horizontal)
|
||
{
|
||
availableSize.Height = double.PositiveInfinity;
|
||
for (var i = 0; i < internalChildren.Count; i++)
|
||
{
|
||
var child = internalChildren[i];
|
||
|
||
child.Measure(availableSize);
|
||
var childDesiredSize = child.DesiredSize;
|
||
var childWidth = childWidthGetter.Invoke(childDesiredSize);
|
||
var childHeight = childHeightGetter.Invoke(childDesiredSize);
|
||
|
||
offsetX += childWidth;
|
||
|
||
if (child.Visibility != Visibility.Collapsed)
|
||
{
|
||
offsetX += horizontalSpacing;
|
||
}
|
||
|
||
if (offsetX - horizontalSpacing > availableSize.Width)
|
||
{
|
||
currentLineLength = offsetX - horizontalSpacing - childWidth - horizontalSpacing;
|
||
if (currentLineLength > maxLineLength)
|
||
{
|
||
maxLineLength = currentLineLength;
|
||
}
|
||
|
||
offsetX = childWidth + horizontalSpacing;
|
||
offsetY += currentLineSize;
|
||
offsetY += verticalSpacing;
|
||
currentLineSize = 0;
|
||
}
|
||
|
||
if (childHeight > currentLineSize)
|
||
{
|
||
currentLineSize = childHeight;
|
||
}
|
||
}
|
||
|
||
currentLineLength = offsetX - horizontalSpacing;
|
||
if (currentLineLength > maxLineLength)
|
||
{
|
||
maxLineLength = currentLineLength;
|
||
}
|
||
|
||
offsetY += currentLineSize;
|
||
offsetY += verticalSpacing;
|
||
|
||
return new Size(maxLineLength, offsetY - verticalSpacing);
|
||
}
|
||
else
|
||
{
|
||
availableSize.Width = double.PositiveInfinity;
|
||
for (var i = 0; i < internalChildren.Count; i++)
|
||
{
|
||
var child = internalChildren[i];
|
||
|
||
child.Measure(availableSize);
|
||
var childDesiredSize = child.DesiredSize;
|
||
var childWidth = childWidthGetter.Invoke(childDesiredSize);
|
||
var childHeight = childHeightGetter.Invoke(childDesiredSize);
|
||
|
||
offsetY += childHeight;
|
||
|
||
if (child.Visibility != Visibility.Collapsed)
|
||
{
|
||
offsetY += verticalSpacing;
|
||
}
|
||
|
||
if (offsetY - verticalSpacing > availableSize.Height)
|
||
{
|
||
currentLineLength = offsetY - horizontalSpacing - childHeight - verticalSpacing;
|
||
if (currentLineLength > maxLineLength)
|
||
{
|
||
maxLineLength = currentLineLength;
|
||
}
|
||
|
||
offsetY = childHeight + verticalSpacing;
|
||
offsetX += currentLineSize;
|
||
offsetX += horizontalSpacing;
|
||
currentLineSize = 0;
|
||
}
|
||
|
||
if (childWidth > currentLineSize)
|
||
currentLineSize = childWidth;
|
||
}
|
||
|
||
currentLineLength = offsetY - verticalSpacing;
|
||
if (currentLineLength > maxLineLength)
|
||
{
|
||
maxLineLength = currentLineLength;
|
||
}
|
||
|
||
offsetX += currentLineSize;
|
||
offsetX += horizontalSpacing;
|
||
|
||
return new Size(offsetX - horizontalSpacing, maxLineLength);
|
||
}
|
||
}
|
||
|
||
/// <inheritdoc />
|
||
protected override Size ArrangeOverride(Size finalSize)
|
||
{
|
||
var itemWidth = ItemWidth;
|
||
var itemHeight = ItemHeight;
|
||
var verticalSpacing = VerticalSpacing;
|
||
var horizontalSpacing = HorizontalSpacing;
|
||
|
||
var tempOffset = 0d;
|
||
|
||
Func<Size, double> childWidthGetter = double.IsNaN(itemWidth) ? size => size.Width : _ => itemWidth;
|
||
Func<Size, double> childHeightGetter = double.IsNaN(itemHeight) ? size => size.Height : _ => itemHeight;
|
||
|
||
var internalChildren = InternalChildren;
|
||
var currentLineSize = 0d;
|
||
var currentLineOffsetX = 0d;
|
||
var currentLineOffsetY = 0d;
|
||
var currentLineIndexStart = 0;
|
||
if (Orientation == Orientation.Horizontal)
|
||
{
|
||
for (var i = 0; i < internalChildren.Count; i++)
|
||
{
|
||
var child = internalChildren[i];
|
||
var childDesiredSize = child.DesiredSize;
|
||
var childWidth = childWidthGetter.Invoke(childDesiredSize);
|
||
var childHeight = childHeightGetter.Invoke(childDesiredSize);
|
||
|
||
tempOffset += childWidth;
|
||
|
||
if (child.Visibility != Visibility.Collapsed)
|
||
{
|
||
tempOffset += horizontalSpacing;
|
||
}
|
||
|
||
if (tempOffset - horizontalSpacing > finalSize.Width)
|
||
{
|
||
ArrangeLineHorizontal(
|
||
internalChildren,
|
||
currentLineIndexStart,
|
||
i,
|
||
currentLineOffsetX,
|
||
currentLineOffsetY,
|
||
currentLineSize,
|
||
horizontalSpacing,
|
||
childWidthGetter,
|
||
childHeightGetter);
|
||
|
||
currentLineOffsetX = 0;
|
||
currentLineOffsetY += currentLineSize;
|
||
currentLineOffsetY += verticalSpacing;
|
||
currentLineIndexStart = i;
|
||
|
||
currentLineSize = 0;
|
||
tempOffset = childWidth + horizontalSpacing;
|
||
}
|
||
|
||
if (childHeight > currentLineSize)
|
||
{
|
||
currentLineSize = childHeight;
|
||
}
|
||
}
|
||
|
||
ArrangeLineHorizontal(
|
||
internalChildren,
|
||
currentLineIndexStart,
|
||
internalChildren.Count,
|
||
currentLineOffsetX,
|
||
currentLineOffsetY,
|
||
currentLineSize,
|
||
horizontalSpacing,
|
||
childWidthGetter,
|
||
childHeightGetter);
|
||
}
|
||
else
|
||
{
|
||
for (var i = 0; i < internalChildren.Count; i++)
|
||
{
|
||
var child = internalChildren[i];
|
||
var childDesiredSize = child.DesiredSize;
|
||
var childWidth = childWidthGetter.Invoke(childDesiredSize);
|
||
var childHeight = childHeightGetter.Invoke(childDesiredSize);
|
||
|
||
tempOffset += childHeight;
|
||
|
||
if (child.Visibility != Visibility.Collapsed)
|
||
{
|
||
tempOffset += verticalSpacing;
|
||
}
|
||
|
||
if (tempOffset - verticalSpacing > finalSize.Height)
|
||
{
|
||
ArrangeLineVertical(
|
||
internalChildren,
|
||
currentLineIndexStart,
|
||
i,
|
||
currentLineOffsetX,
|
||
currentLineOffsetY,
|
||
currentLineSize,
|
||
verticalSpacing,
|
||
childWidthGetter,
|
||
childHeightGetter);
|
||
|
||
currentLineOffsetY = 0;
|
||
currentLineOffsetX += currentLineSize;
|
||
currentLineOffsetX += horizontalSpacing;
|
||
currentLineIndexStart = i;
|
||
|
||
currentLineSize = 0;
|
||
tempOffset = childHeight + verticalSpacing;
|
||
}
|
||
|
||
if (childWidth > currentLineSize)
|
||
{
|
||
currentLineSize = childWidth;
|
||
}
|
||
}
|
||
|
||
ArrangeLineVertical(
|
||
internalChildren,
|
||
currentLineIndexStart,
|
||
internalChildren.Count,
|
||
currentLineOffsetX,
|
||
currentLineOffsetY,
|
||
currentLineSize,
|
||
verticalSpacing,
|
||
childWidthGetter,
|
||
childHeightGetter);
|
||
}
|
||
|
||
return finalSize;
|
||
|
||
static void ArrangeLineHorizontal(
|
||
UIElementCollection children,
|
||
int childIndexStart,
|
||
int childIndexEnd,
|
||
double currentLineOffsetX,
|
||
double currentLineOffsetY,
|
||
double currentLineSize,
|
||
double spacing,
|
||
Func<Size, double> widthGetter,
|
||
Func<Size, double> heightGetter)
|
||
{
|
||
var lineChildOffset = 0d;
|
||
for (var j = childIndexStart; j < childIndexEnd; j++)
|
||
{
|
||
var lineChild = children[j];
|
||
var lineChildDesiredSize = lineChild.DesiredSize;
|
||
var lineChildWidth = widthGetter.Invoke(lineChildDesiredSize);
|
||
heightGetter.Invoke(lineChildDesiredSize);
|
||
|
||
lineChild.Arrange(new Rect(currentLineOffsetX + lineChildOffset, currentLineOffsetY, lineChildWidth, currentLineSize));
|
||
|
||
lineChildOffset += lineChildWidth;
|
||
|
||
if (lineChild.Visibility != Visibility.Collapsed)
|
||
{
|
||
lineChildOffset += spacing;
|
||
}
|
||
}
|
||
}
|
||
|
||
static void ArrangeLineVertical(
|
||
UIElementCollection children,
|
||
int childIndexStart,
|
||
int childIndexEnd,
|
||
double currentLineOffsetX,
|
||
double currentLineOffsetY,
|
||
double currentLineSize,
|
||
double spacing,
|
||
Func<Size, double> widthGetter,
|
||
Func<Size, double> heightGetter)
|
||
{
|
||
var lineChildOffset = 0d;
|
||
for (var j = childIndexStart; j < childIndexEnd; j++)
|
||
{
|
||
var lineChild = children[j];
|
||
var lineChildDesiredSize = lineChild.DesiredSize;
|
||
widthGetter.Invoke(lineChildDesiredSize);
|
||
var lineChildHeight = heightGetter.Invoke(lineChildDesiredSize);
|
||
|
||
lineChild.Arrange(new Rect(currentLineOffsetX, currentLineOffsetY + lineChildOffset, currentLineSize, lineChildHeight));
|
||
|
||
lineChildOffset += lineChildHeight;
|
||
|
||
if (lineChild.Visibility != Visibility.Collapsed)
|
||
{
|
||
lineChildOffset += spacing;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|