Windows Community Toolkit 4.0 - DataGrid - Part02

概述

在上面一篇 Windows Community Toolkit 4.0 - DataGrid - Part01 中，我們針對 DataGrid 控制項的 CollectionView 部分做了詳細分享。而在本篇，我們會對 Utilities 文件夾中的類做詳細的分享。

下麵是 Windows Community Toolkit Sample App 的示例截圖和 code/doc 地址：

Windows Community Toolkit Doc - DataGrid

Windows Community Toolkit Source Code - DataGrid

Namespace: Microsoft.Toolkit.Uwp.UI.Controls; Nuget: Microsoft.Toolkit.Uwp.UI.Controls.DataGrid;

開發過程

首先再來看一下 Utilities 文件夾的代碼結構：

可以看到 Utilities 文件夾中的類主要是一些基礎和幫助類，下麵我們來看一些重要的類代碼：

1. DoubleUtil

該類的功能主要是判斷兩個 double 類型的值之間是否接近，大小關係等；這些方法中用到了一個 AreClose(v1, v2) 的方法，這個方法主要判斷兩個數值是否相近，計算方法是，當兩個值的差，除以兩個值的絕對值和加10.0 的值小於 double epsilon 時，認為兩個數值是接近的。而 double epsilon 表示大於零的最小 double 數值。

internal const double DBL_EPSILON = 1.1102230246251567e-016;

public static bool AreClose(double value1, double value2)
{
    // in case they are Infinities (then epsilon check does not work)
    if (value1 == value2)
    {
        return true;
    }

    // This computes (|value1-value2| / (|value1| + |value2| + 10.0)) < DBL_EPSILON
    double eps = (Math.Abs(value1) + Math.Abs(value2) + 10.0) * DBL_EPSILON;
    double delta = value1 - value2;
    return -eps < delta && eps > delta;
}

2. Extensions

該類的功能是 DataGrid 控制項的擴展，主要有以下擴展方法：

• IsHandlerSuspended - 處理器暫停的標識；
• ContainsChild - 遍歷可視化樹，判斷當前控制項是否包含某個 child 元素，該方法在 WPF UWP 的很多控制項中都有過體現；
• ContainsFocusedElement - 遍歷可視化樹，判斷當前控制項是否包含獲得焦點的元素；
• GetIsReadOnly - 獲取控制項的只讀屬性；
• GetItemType - 獲取元素類型，分為枚舉和集合兩種分類來判斷；
• SetStyleWithType - 設置元素的樣式；
• SetValueNoCallback - 設置值並中斷回調；
• Translate - 計算起始和終止元素間的坐標移動；
• EnsureMeasured - 在控制項被置於背景層時，需要計算尺寸；
• SuspendHandler - 暫停處理器的處理；

3. IndexToValueTable

該類的功能是 DataGrid 控制項的索引和值表之間的處理，我們看幾個重要的方法：

1) ContainsAll()

該方法的作用是判斷給定的 startIndex 和 endIndex 間的索引範圍，是否全部包含在表中；判斷過程主要是根據 startIndex 和 endIndex 的值，以及 list 中的每個 range 的 UpperBound 和 LowerBound 的值，判斷 startIndex 和 endIndex 是否包含在某個 range 中；

public bool ContainsAll(int startIndex, int endIndex)
{
    int start = -1;
    int end = -1;

    foreach (Range<T> range in _list)
    {
        if (start == -1 && range.UpperBound >= startIndex)
        {
            if (startIndex < range.LowerBound)
            {
                return false;
            }

            start = startIndex;
            end = range.UpperBound;
            if (end >= endIndex)
            {
                return true;
            }
        }
        else if (start != -1)
        {
            if (range.LowerBound > end + 1)
            {
                return false;
            }

            end = range.UpperBound;
            if (end >= endIndex)
            {
                return true;
            }
        }
    }

    return false;
}

2) FindRangeIndex() 

獲取當前 range 的索引，計算過程是：遍歷 list 中的 range 集合，計算 front 和 end，每次獲取中間值，如果 range 的上下限包含該 index，返回該 index；否則，根據 front 和 end 的對比，計算值作為索引返回；

private int FindRangeIndex(int index)
{
    if (_list.Count == 0)
    {
        return -1;
    }

    int front = 0;
    int end = _list.Count - 1;
    Range<T> range = null;
    while (end > front)
    {
        int median = (front + end) / 2;
        range = _list[median];
        if (range.UpperBound < index)
        {
            front = median + 1;
        }
        else if (range.LowerBound > index)
        {
            end = median - 1;
        }
        else
        {
            return median;
        }
    }

    if (front == end)
    {
        range = _list[front];
        if (range.ContainsIndex(index) || (range.UpperBound < index))
        {
            return front;
        }
        else
        {
            return front - 1;
        }
    }
    else
    {
        return end;
    }
}

4. TypeHelper

該類是 DataGrid 控制項的類型幫助類，主要功能是獲取類型，屬性信息，顯示名等信息。這些方法都是較通用的方法，大家如果有興趣，可以去詳細查看代碼，這裡不做贅述。

5. ValidationUtil

該類的主要功能是 dataGrid 控制項的校驗，我們來看看 FindEqualValidationResult 方法：

public static ValidationResult FindEqualValidationResult(this ICollection<ValidationResult> collection, ValidationResult target)
{
    foreach (ValidationResult oldValidationResult in collection)
    {
        if (oldValidationResult.ErrorMessage == target.ErrorMessage)
        {
            bool movedOld = true;
            bool movedTarget = true;
            IEnumerator<string> oldEnumerator = oldValidationResult.MemberNames.GetEnumerator();
            IEnumerator<string> targetEnumerator = target.MemberNames.GetEnumerator();
            while (movedOld && movedTarget)
            {
                movedOld = oldEnumerator.MoveNext();
                movedTarget = targetEnumerator.MoveNext();

                if (!movedOld && !movedTarget)
                {
                    return oldValidationResult;
                }

                if (movedOld != movedTarget || oldEnumerator.Current != targetEnumerator.Current)
                {
                    break;
                }
            }
        }
    }

    return null;
}

6. VisualStates

該類是 DataGrid 控制項的可視化狀態類，主要分類一下幾種狀態組：

• Common - Normal，PointerOver，Pressed，Disabled
• Expanded - Expanded，Collapsed，Empty
• Focus - Unfocused，Focused
• Selection - Selected，Unselected
• Active - Active，Inactive
• Current - Regular，Current，CurrentWithFocus
• Interaction - Display，Editing
• Sort - Unsorted，SortAscending，SortDescending
• Validation - Invalid，RowInvalid，RowValid，Valid
• ScrollBarsSeparator - SeparatorExpanded，SeparatorCollapsed，SeparatorExpandedWithoutAnimation，SeparatorCollapsedWithoutAnimation
• ScrollBars - TouchIndicator，MouseIndicator，MouseIndicatorFull，NoIndicator

總結

這裡我們把 DataGrid 的 Utilities 相關類介紹完成了，作為 DataGrid 相關分享的第二篇，後面我們會繼續分享最重要的 DataGrid 的相關重點。

最後，再跟大家安利一下 WindowsCommunityToolkit 的官方微博：https://weibo.com/u/6506046490, 大家可以通過微博關註最新動態。

衷心感謝 WindowsCommunityToolkit 的作者們傑出的工作，感謝每一位貢獻者，Thank you so much, ALL WindowsCommunityToolkit AUTHORS !!!