经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置：技术经验 » 程序设计 » ASP.net » 查看文章
Windows Community Toolkit 4.0 - DataGrid - Part03
来源：cnblogs　　作者：shaomeng　　时间：2018/9/25 20:39:50　　对本文有异议

概述

在上面一篇 Windows Community Toolkit 4.0 - DataGrid - Part02 中，我们针对 DataGrid 控件的 Utilities 部分做了详细分享。而在本篇，我们会对控件中最重要的 DataGrid 文件夹中的类做详细的分享。

下面是 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;

 

开发过程

DataGrid 文件夹中是 DataGrid 控件最重要的功能，首先我们还是先来看一下类结构：

包括了 Automation；DataGrid，DataGridColumn，DataGridRow，DataGridCell 控件实现，事件处理参数类和数据类等；

接着我们看几个重要的类和方法：

1. DataGrid.cs

这个类是 DataGrid 控件的主要处理类，功能也是比较复杂，单个类的代码行数是 9001 行，我们只挑两个方法来看一下。其他方法大家有兴趣或用到时可以在 DataGrid.cs 中查阅。

1) DataGrid()

首先看一下 DataGrid 类的构造方法，之所以看这个方法，是想让大家可以更了解 DataGrid 类中变量的初始化方式，这些变量在不同的交互场景下会被赋予不同的值。

  1. public DataGrid()
  2. {
  3.     this.TabNavigation = KeyboardNavigationMode.Once;
  5.     _loadedRows = new List<DataGridRow>();
  6.     _lostFocusActions = new Queue<Action>();
  7.     _selectedItems = new DataGridSelectedItemsCollection(this);
  8.     _rowGroupHeaderPropertyNameAlternative = Properties.Resources.DefaultRowGroupHeaderPropertyNameAlternative;
  9.     _rowGroupHeaderStyles = new ObservableCollection<Style>();
  10.     _rowGroupHeaderStyles.CollectionChanged += RowGroupHeaderStyles_CollectionChanged;
  11.     _rowGroupHeaderStylesOld = new List<Style>();
  12.     this.RowGroupHeadersTable = new IndexToValueTable<DataGridRowGroupInfo>();
  14.     _collapsedSlotsTable = new IndexToValueTable<Visibility>();
  15.     _validationItems = new Dictionary<INotifyDataErrorInfo, string>();
  16.     _validationResults = new List<ValidationResult>();
  17.     _bindingValidationResults = new List<ValidationResult>();
  18.     _propertyValidationResults = new List<ValidationResult>();
  19.     _indeiValidationResults = new List<ValidationResult>();
  21.     this.ColumnHeaderInteractionInfo = new DataGridColumnHeaderInteractionInfo();
  22.     this.DisplayData = new DataGridDisplayData(this);
  23.     this.ColumnsInternal = CreateColumnsInstance();
  25.     this.RowHeightEstimate = DATAGRID_defaultRowHeight;
  26.     this.RowDetailsHeightEstimate = 0;
  27.     _rowHeaderDesiredWidth = 0;
  29.     this.DataConnection = new DataGridDataConnection(this);
  30.     _showDetailsTable = new IndexToValueTable<Visibility>();
  32.     _focusInputDevice = FocusInputDeviceKind.None;
  33.     _proposedScrollBarsState = ScrollBarVisualState.NoIndicator;
  34.     _proposedScrollBarsSeparatorState = ScrollBarsSeparatorVisualState.SeparatorCollapsed;
  36.     this.AnchorSlot = -1;
  37.     _lastEstimatedRow = -1;
  38.     _editingColumnIndex = -1;
  39.     this.CurrentCellCoordinates = new DataGridCellCoordinates(-1, -1);
  41.     this.RowGroupHeaderHeightEstimate = DATAGRID_defaultRowHeight;
  43.     this.LastHandledKeyDown = VirtualKey.None;
  45.     this.DefaultStyleKey = typeof(DataGrid);
  47.     HookDataGridEvents();
  48. }

2) ShowScrollBars()

DataGrid 控件中滚动条的处理方法。如果 AreAllScrollBarsCollapsed 为 true，则按照该规则简单处理；如果为 false，先按照 mouse 和 touch 的类型进行判断处理，再根据 UI 设置里的 AreSettingsEnablingAnimations 和 AreSettingsAutoHidingScrollBars 属性来切换滚动条的状态，调用 SwitchScrollBarsVisualStates 方法。

  1. private void ShowScrollBars()
  2. {
  3.     if (this.AreAllScrollBarsCollapsed)
  4.     {
  5.         _proposedScrollBarsState = ScrollBarVisualState.NoIndicator;
  6.         _proposedScrollBarsSeparatorState = ScrollBarsSeparatorVisualState.SeparatorCollapsedWithoutAnimation;
  7.         SwitchScrollBarsVisualStates(_proposedScrollBarsState, _proposedScrollBarsSeparatorState, false /*useTransitions*/);
  8.     }
  9.     else
  10.     {
  11.         if (_hideScrollBarsTimer != null && _hideScrollBarsTimer.IsEnabled)
  12.         {
  13.             _hideScrollBarsTimer.Stop();
  14.             _hideScrollBarsTimer.Start();
  15.         }
  17.         // Mouse indicators dominate if they are already showing or if we have set the flag to prefer them.
  18.         if (_preferMouseIndicators || _showingMouseIndicators)
  19.         {
  20.             if (this.AreBothScrollBarsVisible && (_isPointerOverHorizontalScrollBar || _isPointerOverVerticalScrollBar))
  21.             {
  22.                 _proposedScrollBarsState = ScrollBarVisualState.MouseIndicatorFull;
  23.             }
  24.             else
  25.             {
  26.                 _proposedScrollBarsState = ScrollBarVisualState.MouseIndicator;
  27.             }
  29.             _showingMouseIndicators = true;
  30.         }
  31.         else
  32.         {
  33.             _proposedScrollBarsState = ScrollBarVisualState.TouchIndicator;
  34.         }
  36.         // Select the proper state for the scroll bars separator square within the GroupScrollBarsSeparator group:
  37.         if (UISettingsHelper.AreSettingsEnablingAnimations)
  38.         {
  39.             // When OS animations are turned on, show the square when a scroll bar is shown unless the DataGrid is disabled, using an animation.
  40.             _proposedScrollBarsSeparatorState =
  41.                 this.IsEnabled &&
  42.                 _proposedScrollBarsState == ScrollBarVisualState.MouseIndicatorFull ?
  43.                 ScrollBarsSeparatorVisualState.SeparatorExpanded : ScrollBarsSeparatorVisualState.SeparatorCollapsed;
  44.         }
  45.         else
  46.         {
  47.             // OS animations are turned off. Show or hide the square depending on the presence of a scroll bars, without an animation.
  48.             // When the DataGrid is disabled, hide the square in sync with the scroll bar(s).
  49.             if (_proposedScrollBarsState == ScrollBarVisualState.MouseIndicatorFull)
  50.             {
  51.                 _proposedScrollBarsSeparatorState = this.IsEnabled ? ScrollBarsSeparatorVisualState.SeparatorExpandedWithoutAnimation : ScrollBarsSeparatorVisualState.SeparatorCollapsed;
  52.             }
  53.             else
  54.             {
  55.                 _proposedScrollBarsSeparatorState = this.IsEnabled ? ScrollBarsSeparatorVisualState.SeparatorCollapsedWithoutAnimation : ScrollBarsSeparatorVisualState.SeparatorCollapsed;
  56.             }
  57.         }
  59.         if (!UISettingsHelper.AreSettingsAutoHidingScrollBars)
  60.         {
  61.             if (this.AreBothScrollBarsVisible)
  62.             {
  63.                 if (UISettingsHelper.AreSettingsEnablingAnimations)
  64.                 {
  65.                     SwitchScrollBarsVisualStates(ScrollBarVisualState.MouseIndicatorFull, this.IsEnabled ? ScrollBarsSeparatorVisualState.SeparatorExpanded : ScrollBarsSeparatorVisualState.SeparatorCollapsed, true /*useTransitions*/);
  66.                 }
  67.                 else
  68.                 {
  69.                     SwitchScrollBarsVisualStates(ScrollBarVisualState.MouseIndicatorFull, this.IsEnabled ? ScrollBarsSeparatorVisualState.SeparatorExpandedWithoutAnimation : ScrollBarsSeparatorVisualState.SeparatorCollapsed, true /*useTransitions*/);
  70.                 }
  71.             }
  72.             else
  73.             {
  74.                 if (UISettingsHelper.AreSettingsEnablingAnimations)
  75.                 {
  76.                     SwitchScrollBarsVisualStates(ScrollBarVisualState.MouseIndicator, ScrollBarsSeparatorVisualState.SeparatorCollapsed, true /*useTransitions*/);
  77.                 }
  78.                 else
  79.                 {
  80.                     SwitchScrollBarsVisualStates(ScrollBarVisualState.MouseIndicator, this.IsEnabled ? ScrollBarsSeparatorVisualState.SeparatorCollapsedWithoutAnimation : ScrollBarsSeparatorVisualState.SeparatorCollapsed, true /*useTransitions*/);
  81.                 }
  82.             }
  83.         }
  84.         else
  85.         {
  86.             SwitchScrollBarsVisualStates(_proposedScrollBarsState, _proposedScrollBarsSeparatorState, true /*useTransitions*/);
  87.         }
  88.     }
  89. }

2. DataGridCellEditEndedEventArgs.cs

DataGrid 控件中有很多事件处理参数类，我们只看其中一个 DataGridCellEditEndedEventArgs 吧。很显然这个事件包含了 column row 和 editAction 三个变量，大家看到其他时间参数时，可以具体再分析。

  1. public class DataGridCellEditEndedEventArgs : EventArgs
  2. {
  3.    public DataGridCellEditEndedEventArgs(DataGridColumn column, DataGridRow row, DataGridEditAction editAction)
  4.     {
  5.         this.Column = column;
  6.         this.Row = row;
  7.         this.EditAction = editAction;
  8.     }
  10.     public DataGridColumn Column
  11.     {
  12.         get;
  13.         private set;
  14.     }
  16.      public DataGridEditAction EditAction
  17.     {
  18.         get;
  19.         private set;
  20.     }
  22.     public DataGridRow Row
  23.     {
  24.         get;
  25.         private set;
  26.     }
  27. }

3. DataGridCellCollection.cs

DataGrid 控件中有很多数据类，我们看一个单元格集合类，可以看到集合中有 _cells，Count 变量，Insert 和 RemoveAt 方法等，处理逻辑都比较简单。

  1. internal class DataGridCellCollection
  2. {
  3.     private List<DataGridCell> _cells;
  4.     private DataGridRow _owningRow;
  6.     internal event EventHandler<DataGridCellEventArgs> CellAdded;
  8.     internal event EventHandler<DataGridCellEventArgs> CellRemoved;
  10.     public DataGridCellCollection(DataGridRow owningRow)
  11.     {
  12.         _owningRow = owningRow;
  13.         _cells = new List<DataGridCell>();
  14.     }
  16.     public int Count
  17.     {
  18.         get
  19.         {
  20.             return _cells.Count;
  21.         }
  22.     }
  24.     public IEnumerator GetEnumerator()
  25.     {
  26.         return _cells.GetEnumerator();
  27.     }
  29.     public void Insert(int cellIndex, DataGridCell cell)
  30.     {
  31.         Debug.Assert(cellIndex >= 0 && cellIndex <= _cells.Count, "Expected cellIndex between 0 and _cells.Count inclusive.");
  32.         Debug.Assert(cell != null, "Expected non-null cell.");
  34.         cell.OwningRow = _owningRow;
  35.         _cells.Insert(cellIndex, cell);
  37.         if (CellAdded != null)
  38.         {
  39.             CellAdded(this, new DataGridCellEventArgs(cell));
  40.         }
  41.     }
  43.     public void RemoveAt(int cellIndex)
  44.     {
  45.         DataGridCell dataGridCell = _cells[cellIndex];
  46.         _cells.RemoveAt(cellIndex);
  47.         dataGridCell.OwningRow = null;
  48.         if (CellRemoved != null)
  49.         {
  50.             CellRemoved(this, new DataGridCellEventArgs(dataGridCell));
  51.         }
  52.     }
  54.     public DataGridCell this[int index]
  55.     {
  56.         get
  57.         {
  58.             if (index < 0 || index >= _cells.Count)
  59.             {
  60.                 throw DataGridError.DataGrid.ValueMustBeBetween("index", "Index", 0, true, _cells.Count, false);
  61.             }
  63.             return _cells[index];
  64.         }
  65.     }
  66. }

4. DataGridCell.cs

DataGrid 控件的单元格类，处理比较简单，我们通过构造方法来看一下类中都涉及到哪些事件的处理；可以看到，光标的一系列处理都有涉及。

  1. public DataGridCell()
  2. {
  3.     this.IsTapEnabled = true;
  4.     this.AddHandler(UIElement.TappedEvent, new TappedEventHandler(DataGridCell_PointerTapped), true /*handledEventsToo*/);
  6.     this.PointerCanceled += new PointerEventHandler(DataGridCell_PointerCanceled);
  7.     this.PointerCaptureLost += new PointerEventHandler(DataGridCell_PointerCaptureLost);
  8.     this.PointerPressed += new PointerEventHandler(DataGridCell_PointerPressed);
  9.     this.PointerReleased += new PointerEventHandler(DataGridCell_PointerReleased);
  10.     this.PointerEntered += new PointerEventHandler(DataGridCell_PointerEntered);
  11.     this.PointerExited += new PointerEventHandler(DataGridCell_PointerExited);
  12.     this.PointerMoved += new PointerEventHandler(DataGridCell_PointerMoved);
  14.     DefaultStyleKey = typeof(DataGridCell);
  15. }

 

总结

这里我们把 DataGrid 的 DataGrid 相关类介绍完成了，代码部分的 CollectionView，Utilities 和 DataGrid 就介绍完了。因为代码本身比较复杂，量也很大，所以我们只挑选了一小部分代码来分享，大家具体用到时可以再具体分析。

接下来我们会就 DataGrid 控件的各种编辑功能，各种自定义功能等做进一步的使用方式的分享。

最后，再跟大家安利一下 WindowsCommunityToolkit 的官方微博：https://weibo.com/u/6506046490, 大家可以通过微博关注最新动态。

衷心感谢 WindowsCommunityToolkit 的作者们杰出的工作，感谢每一位贡献者，Thank you so much, ALL WindowsCommunityToolkit AUTHORS !!!

 

 友情链接：直通硅谷 　点职佳 　北美留学生论坛

ASP.net热门文章

  • 【Dotnet 工具箱】WPF UI - 现代化设计的开源 WPF 框架
  • net core 使用 SqlSugar
  • .NETCore下CI/CD之自动化测试
  • .net core部署到linux可能碰到的问题
  • Abp vNext 自定义 Ef Core 仓储引发异常
  • .NetCore 消息队列的使用
  • .NetCore WebApi——基于JWT的简单身份认证与授权（Swagger）
  • Abp.NHibernate连接PostgreSQl数据库
  • ModelValidator基于元数据的验证
  • .NET MAUI 安卓应用开发初体验

    • ASP.net推荐文章

  • Gradio.NET 支持 .NET 8 简化 Web 应用开发
  • .NET 轻量化定时任务调度 FreeScheduler
  • WPF 模仿前端大佬写一个Hover效果
  • WPF 模拟UWP原生窗口样式——亚克力|云母材质、自定义标题栏样式、原生DWM动画 （附我封装好的类）
  • .NET 音频采集
  • .NET8 Blazor 从入门到精通：（三）类库和表单
  • wpf 如何7步写一个badge控件
  • .NET 高效Nuget管理工具（开源）
  • .NET 8 跨平台高性能边缘采集网关
  • .NET 窗口/屏幕录制

    • 本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

    W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
    关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
    皖ICP备17017327号-2　皖公网安备34020702000426号