ShrlAlgo/Shrlalgo.RvKits
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

功能更新

Browse Source
This commit is contained in:
GG Z
2026-02-12 21:29:00 +08:00
parent a9faf251be
commit b3479d1f39
342 changed files with 4671 additions and 2223 deletions
Download Patch File Download Diff File Expand all files Collapse all files

235
Melskin/Layout/UniformGrid.cs Normal file
View File

@@ -0,0 +1,235 @@
namespace Melskin.Layout
{
/// <summary>
/// 一个自定义布局面板，可将其子元素排列在网格中。
/// 关键功能: 可将最后一行的子元素进行水平拉伸，以填满整行。
/// </summary>
public class UniformGrid : Panel
{
#region Dependency Properties
/// <summary>
/// 表示UniformGrid控件的列数属性的依赖属性。此属性用于定义网格中的列数，必须大于0，默认值为1。
/// </summary>
public static readonly DependencyProperty ColumnsProperty =
DependencyProperty.Register(nameof(Columns), typeof(int), typeof(UniformGrid),
new FrameworkPropertyMetadata(1, FrameworkPropertyMetadataOptions.AffectsMeasure));
/// <summary>
/// 获取或设置网格的列数。必须大于0。默认为1。
/// </summary>
public int Columns
{
get => (int)GetValue(ColumnsProperty);
set => SetValue(ColumnsProperty, value);
}
/// <summary>
/// 表示UniformGrid控件的行数属性的依赖属性。此属性用于定义网格中的行数，可以设置为0以自动计算行数，默认值为0。
/// </summary>
public static readonly DependencyProperty RowsProperty =
DependencyProperty.Register(nameof(Rows), typeof(int), typeof(UniformGrid),
new FrameworkPropertyMetadata(0, FrameworkPropertyMetadataOptions.AffectsMeasure));
/// <summary>
/// 获取或设置网格的行数。
/// 如果为0（默认），行数将根据子元素数量和列数自动计算。
/// </summary>
public int Rows
{
get => (int)GetValue(RowsProperty);
set => SetValue(RowsProperty, value);
}
/// <summary>
/// 表示UniformGrid控件的列间距属性的依赖属性。此属性用于定义网格中每列之间的间距，类型为double，默认值为0.0。
/// </summary>
public static readonly DependencyProperty ColumnSpacingProperty =
DependencyProperty.Register(nameof(ColumnSpacing), typeof(double), typeof(UniformGrid),
new FrameworkPropertyMetadata(0.0, FrameworkPropertyMetadataOptions.AffectsMeasure));
/// <summary>
/// 表示UniformGrid控件的列间距属性。此属性用于定义网格中每列之间的间距，值为double类型，默认值为0.0。
/// </summary>
public double ColumnSpacing
{
get => (double)GetValue(ColumnSpacingProperty);
set => SetValue(ColumnSpacingProperty, value);
}
/// <summary>
/// 表示UniformGrid控件的行间距属性的依赖属性。此属性用于定义网格中各行之间的间距，默认值为0。
/// </summary>
public static readonly DependencyProperty RowSpacingProperty =
DependencyProperty.Register(nameof(RowSpacing), typeof(double), typeof(UniformGrid),
new FrameworkPropertyMetadata(0.0, FrameworkPropertyMetadataOptions.AffectsMeasure));
/// <summary>
/// 表示UniformGrid控件的行间距属性。此属性用于定义网格中各行之间的间距，默认值为0.0。
/// </summary>
public double RowSpacing
{
get => (double)GetValue(RowSpacingProperty);
set => SetValue(RowSpacingProperty, value);
}
/// <summary>
/// 表示UniformGrid控件的最后一行是否填充属性的依赖属性。此属性用于决定当最后一行未被完全填满时，是否拉伸子元素以填满整行，默认值为true。
/// </summary>
public static readonly DependencyProperty IsFillLastRowProperty =
DependencyProperty.Register(nameof(IsFillLastRow), typeof(bool), typeof(UniformGrid),
new FrameworkPropertyMetadata(true, FrameworkPropertyMetadataOptions.AffectsArrange));
/// <summary>
/// 获取或设置是否水平拉伸最后一行的子元素，以填满该行的全部宽度。
/// 例如，一个3列的网格有5个元素，当此属性为 true 时，最后两个元素会自动变宽以填满3个列的空间。
/// </summary>
public bool IsFillLastRow
{
get => (bool)GetValue(IsFillLastRowProperty);
set => SetValue(IsFillLastRowProperty, value);
}
/// <summary>
/// 表示UniformGrid控件的圆角半径属性的依赖属性。此属性用于定义网格边角的圆角大小，使用CornerRadius结构表示，默认值为默认构造的CornerRadius实例。
/// </summary>
public static readonly DependencyProperty CornerRadiusProperty =
DependencyProperty.Register(nameof(CornerRadius), typeof(CornerRadius), typeof(UniformGrid),
new FrameworkPropertyMetadata(default(CornerRadius), FrameworkPropertyMetadataOptions.AffectsRender));
/// <summary>
/// 表示UniformGrid控件的圆角半径属性。此属性用于定义网格每个角落的圆角大小，可以通过设置不同的值来实现四角的不同圆角效果，默认值为所有角均为0。
/// </summary>
public CornerRadius CornerRadius
{
get => (CornerRadius)GetValue(CornerRadiusProperty);
set => SetValue(CornerRadiusProperty, value);
}
#endregion
private int computedRows;
private int computedColumns;
/// <inheritdoc/>
protected override Size MeasureOverride(Size availableSize)
{
computedColumns = Math.Max(1, Columns);
var visibleChildren = InternalChildren.Cast<UIElement>().Where(c => c.Visibility != Visibility.Collapsed).ToList();
if (Rows > 0)
{
computedRows = Rows;
}
else
{
computedRows = (visibleChildren.Count + computedColumns - 1) / computedColumns;
if (computedRows == 0) computedRows = 1;
}
double maxChildWidth = 0;
double maxChildHeight = 0;
// 所有子元素共享相同的可用尺寸
foreach (var child in visibleChildren)
{
child.Measure(new Size(double.PositiveInfinity, double.PositiveInfinity));
maxChildWidth = Math.Max(maxChildWidth, child.DesiredSize.Width);
maxChildHeight = Math.Max(maxChildHeight, child.DesiredSize.Height);
}
var totalWidth = maxChildWidth * computedColumns + ColumnSpacing * (computedColumns - 1);
var totalHeight = maxChildHeight * computedRows + RowSpacing * (computedRows - 1);
return new Size(totalWidth, totalHeight);
}
/// <inheritdoc />
protected override Size ArrangeOverride(Size finalSize)
{
var visibleChildren = InternalChildren.Cast<UIElement>().Where(c => c.Visibility != Visibility.Collapsed).ToList();
if (visibleChildren.Count == 0) return finalSize;
var cellWidth = Math.Max(0, (finalSize.Width - (computedColumns - 1) * ColumnSpacing) / computedColumns);
var cellHeight = Math.Max(0, (finalSize.Height - (computedRows - 1) * RowSpacing) / computedRows);
var itemsInFullRows = (computedRows - 1) * computedColumns;
var lastRowItemCount = visibleChildren.Count - itemsInFullRows;
var lastRowCellWidth = cellWidth;
if (IsFillLastRow && lastRowItemCount > 0)
{
// **核心逻辑**: 为最后一行重新计算单元格宽度
lastRowCellWidth = (finalSize.Width - (lastRowItemCount - 1) * ColumnSpacing) / lastRowItemCount;
}
for (var i = 0; i < visibleChildren.Count; i++)
{
var child = visibleChildren[i];
var row = i / computedColumns;
var col = i % computedColumns;
var currentCellWidth = (row == computedRows - 1) ? lastRowCellWidth : cellWidth;
// 如果是最后一行，x坐标的计算需要基于该行内的索引和新的单元格宽度
double x;
if (row == computedRows - 1 && IsFillLastRow)
{
var colInLastRow = i - itemsInFullRows;
x = colInLastRow * (currentCellWidth + ColumnSpacing);
}
else
{
x = col * (cellWidth + ColumnSpacing);
}
var y = row * (cellHeight + RowSpacing);
child.Arrange(new Rect(x, y, currentCellWidth, cellHeight));
}
return finalSize;
}
#region Clipping Logic (保持不变)
/// <summary>
/// 绘制UniformGrid的视觉效果。
/// </summary>
/// <param name="dc">用于绘制的DrawingContext。</param>
protected override void OnRender(DrawingContext dc)
{
ApplyClip();
base.OnRender(dc);
}
private static bool IsZero(double value) => Math.Abs(value) < 1.53E-06;
private void ApplyClip()
{
var cr = CornerRadius;
if (IsZero(cr.TopLeft) && IsZero(cr.TopRight) &&
IsZero(cr.BottomLeft) && IsZero(cr.BottomRight))
{
this.Clip = null;
return;
}
var clipGeometry = new RectangleGeometry(new Rect(this.RenderSize), cr.TopLeft, cr.TopLeft);
if (cr.TopLeft == cr.TopRight && cr.TopLeft == cr.BottomLeft && cr.TopLeft == cr.BottomRight)
{
clipGeometry.RadiusX = cr.TopLeft;
clipGeometry.RadiusY = cr.TopLeft;
}
else
{
clipGeometry.RadiusX = (cr.TopLeft + cr.TopRight) / 2;
clipGeometry.RadiusY = (cr.TopLeft + cr.BottomLeft) / 2;
}
clipGeometry.Freeze();
this.Clip = clipGeometry;
}
#endregion
}
}