功能更新

Melskin/Converters/Internal/AlphaToPercentConverter.cs

@@ -0,0 +1,44 @@
+using System.Globalization;
+using System.Windows.Data;
+
+namespace Melskin.Converters.Internal;
+
+/// <summary>
+/// 该类实现了IValueConverter接口，用于将Alpha透明度值（0-255）与百分比字符串（0%-100%）之间进行转换。
+/// 在Convert方法中，接受一个0到255之间的整数值作为输入，并将其转换为相应的百分比字符串表示形式。
+/// 而在ConvertBack方法中，则执行相反的操作：接收一个百分比字符串，并尝试将其解析回0至255范围内的整数。
+/// 若输入非预期格式或超出合理范围时，转换器将采取适当措施以确保输出结果的有效性。
+/// </summary>
+internal class AlphaToPercentConverter : IValueConverter
+{
+    public static readonly AlphaToPercentConverter Instance = new();
+    /// <inheritdoc />
+    public object Convert(object? value, Type targetType, object? parameter, CultureInfo culture)
+    {
+        if (value is byte alpha)
+        {
+            // 将 0-255 的值转换为 0-100 的百分比字符串
+            return $"{Math.Round(alpha / 255.0 * 100.0)}%";
+        }
+
+        return "100%";
+    }
+
+    /// <inheritdoc />
+    public object ConvertBack(object? value, Type targetType, object? parameter, CultureInfo culture)
+    {
+        if (value is string percentStr)
+        {
+            // 移除 '%' 符号并尝试解析
+            if (double.TryParse(percentStr.TrimEnd('%'), out var percent))
+            {
+                var clampedPercent = Math.Max(0, Math.Min(100, percent));
+                var alpha = (byte)Math.Round(clampedPercent / 100.0 * 255.0);
+                return alpha;
+            }
+        }
+
+        // 如果转换失败，返回 UnsetValue 以保留原值
+        return DependencyProperty.UnsetValue;
+    }
+}