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
開發過程
首先再來看一下 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_EPSILONdouble 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 !!!
Windows Community Toolkit 4.0 - DataGrid - Part02