SourceGrid应用中文帮助
1简介SourceGrid 是一个完全以 C# 托管代码编写的 .NET Windows 窗体网格控件 . SourceGrid 可用于显示或改变表格形式的数据。SourceGrid 可用于绑定到一个数据源(以 DataView 为代表)，或者直接建立每个 单元格。SourceGrid仅使用托管代码(无API或Interop),可以用于任何与.NET 2兼 容的环境中。2安装要使用SourceGrid，你必须有与.NET 2兼容的开发环境(如Visual Studio 2005)。 要下载控件的最新版，请访问 http:/sourceforge.net/projects/sourcegrid. 解压缩该 文件后，可参考项目中的这些程序集：SourceGrid.dll - SourceGrid 内核库DevAge.Core.dll - 共用的辅助功能库DevAge.Windows.Forms.dll - Windows 窗体库SourceGrid.Extensions.dll - 可选库，有 SourceGrid 扩展功能(如 DataGrid, PlanningGrid)典型地，我总是建议把它们复制到与*.xml文件相同的位置，你可以在程序集相 同的目录中找到，以便使用IDE的智能感应录入功能。打开你想要添加网格控件的表单，打开IDE的工具箱，工具箱-右键-选择项- 浏览并增加 SourceGrid.dll 和 SourceGrid.Extensions.dll 程序集到 IDE 的工具箱 中。这些程序集是运行时刻所需的，需要随同你的应用程序一起分发给最终用户。3SourceGrid 控件有 2 种主要的控件包含在 SourceGrid.dll 程序集中:GridVirtual控件-使用虚单元格(ICellVirtual)的网格控件Grid控件-使用实体单元格(ICell)的网格控件因此有 2 种不同的基础对象：虚单元格和实体单元格。虚单元格是确定外观和 行为，但不包含值的单元格。实体单元格与虚单元格有相同的属性，但也包含单 元格的值，因此在网格中与特定位置相关联。在不需要显示大量单元格(典型地，应少于 50,000 个单元格)时，可以使用任 何类型的 Grid 控件。如果需要显示大量单元格，通常你必须使用一个派生于 GridVirtual 的控件。典型地，在本文中，我将使用 Grid 控件，因为它更简单，尤其是作为简单的示 例。但是，同样的代码基本上也能用于 GridVirtual 控件。Grid 控件也用作需要最大弹性的那些特殊的网格。拖动 Grid 控件到你的窗体中，就如同添加其它任何 .NET 控件一样，然后开始 使用它。4基础示例目前，SourceGrid仅有少量的设计时刻支持，因此通常你必须人工编写代码操 作网格。假定你已经有一个名为 grid1 的 Grid 控件，你可以在 Form.Load 事件中编写 如下代码:grid1.BorderStyle = BorderStyle.FixedSingle;grid1.ColumnsCount = 3; grid1.FixedRows = 1;grid1.Rows.Insert(0);grid10,0 = new SourceGrid.Cells.ColumnHeader("String");grid10,1 = new SourceGrid.Cells.ColumnHeader("DateTime"); grid10,2 = new SourceGrid.Cells.ColumnHeader("CheckBox");for (int r = 1; r < 10; r+)grid1.Rows.Insert(r);grid1r,0 = new SourceGrid.Cells.Cell("Hello " + r.ToString(), typeof(string); grid1r,1 = new SourceGrid.Cells.Cell(DateTime.Today, typeof(DateTime); grid1r,2 = new SourceGrid.Cells.CheckBox(null, true);grid1.AutoSizeCells();可以看到，你能像使用 2 维数组一样来使用 grid。 在上面的代码中，我已经 设置了网格的边框，列数，固定行数，建立了一个标头行。对此标头，我使用了 一种 ColumnHeader 单元格。我已经为每列使用了特定类型，从而以一种简单 的外观建立了其他单元格。Cell类自动为指定类型建立了一个适当的编辑器(在 本例中为一个文本框和一个日期时间选择器)。对最后一列，我使用了一个复选 框单元格(CheckBox cell)，允许在单元格中直接显示复选框。每种单元格定义 了它自己的可视外观和行为。建立的网格支持排序，可改变列宽和编辑单元格。下面是一些重要的功能： 如果你想读取或改变单元格中的值，可以使用 grid1r,c.Value 属性， r 和 c 是 单元格的行和列。删除某行，可以编写代码如： grid1.Rows.Remove(r) 改变列宽，可以编写代码如： grid1.Columnsc.Width = 100 如果你想改变某些单元格的可视属性，你必须使用 View 类。 让我们看看下一个示例：grid1.BorderStyle = BorderStyle.FixedSingle; grid1.ColumnsCount = 3;grid1.FixedRows = 1;grid1.Rows.Insert(0);SourceGrid.Cells.Views.ColumnHeader boldHeader =new SourceGrid.Cells.Views.ColumnHeader();boldHeader.Font = new Font(grid1.Font, FontStyle.Bold | FontStyle.Underline); SourceGrid.Cells.Views.Cell yellowView = new SourceGrid.Cells.Views.Cell(); yellowView.BackColor = Color.Yellow;SourceGrid.Cells.Views.CheckBox yellowViewCheck =new SourceGrid.Cells.Views.CheckBox();yellowViewCheck.BackColor = Color.Yellow;grid10, 0 = new SourceGrid.Cells.ColumnHeader("String");grid10, 0.View = boldHeader;grid10, 1 = new SourceGrid.Cells.ColumnHeader("DateTime");grid10, 1.View = boldHeader;grid10, 2 = new SourceGrid.Cells.ColumnHeader("CheckBox");grid10, 2.View = boldHeader;for (int r = 1; r < 10; r+)grid1.Rows.Insert(r);grid1r, 0 = new SourceGrid.Cells.Cell("Hello " + r.ToString(), typeof(string); grid1r, 0.View = yellowView;grid1r, 1 = new SourceGrid.Cells.Cell(DateTime.Today, typeof(DateTime);grid1r, 1.View = yellowView;grid1r, 2 = new SourceGrid.Cells.CheckBox(null, true);grid1r, 2.View = yellowViewCheck;我使用 FontStyle.Bold | FontStyle.Underline 建立了一个列标头外观，其中标准单 元格的外观为黄色背景，复选框单元格的外观为黄色背景。然后我把它们的实例 指派到了每个单元格的 View 属性中。窗体看起来应该像下图所示的一样：你可以注意到，我已经为许多单元格指派了 View 类的同一个实例。这对于优化 所耗用的系统资源是有用的。每个单元格可以有一个编辑器（Editor属性）相关。编辑器用于编辑单元格的值。 你可以人工建立一个编辑类（参阅 SourceGrid.Cells.Editors 命名空间），或者使用 SourceGrid.Cells.Editors.Factory类建立基于某种类型（Type）的编辑器。如果指定 了 Type 参数， 你也可以使用 Cell 构造函数自动调用SourceGrid.Cells.Editors.Factory 。下面是一个示例，建立一些单元格，并且使用上面所述的某一种方法把单元格与编辑器相关联。/A DateTime editorgrid1r, c = new SourceGrid.Cells.Cell(DateTime.Today, typeof(DateTime);/A string editorgrid1r, c = new SourceGrid.Cells.Cell("Ciao", typeof(string);/A double editorgrid1r, c = new SourceGrid.Cells.Cell(58.4);gridlr, c.Editor = SourceGrid.Cells.Editors.Factory.Create(typeof(double);就像 View 类一样，编辑器也可以在一个或数个单元格之间被共用。现在，你可以开始使用 SourceGrid 工作了。5基础概念51Grid 控件如果你需要最有弹性的, 简易而没有太多单元格的网格, Grid 控件是理想的选择. 事实上, 此控件中每个单元格都作为一个 .NET 类来描述 , 因此也占用一定数 量的资源.此外，这是唯一支持RowSpan和ColumnSpan(单元格合并)功能的 网格.在一个Windows窗体中Grid控件是最普通不过的事.这正如增加其他控件(如 按钮,DataGrid)样.首先，建立或者打开一个Windows应用程序项目，然后从 设计器打开一个 Windows 窗体。现在你要准备好使定制工具箱: 以鼠标右键单 击“工具箱 一 .NET Framework 组件一浏览”选中“DevAge.SourceGrid.dll” 现在，网格控件被添加到工具箱中，可以像其他控件一样增加到 Windows 窗体 中。在增加控件到窗体后，我们就可以开始编写代码使用网格控件. 例如，在窗体的 Load 事件中，编写如下代码:gridl.Redim(2, 2);gridl0,0 = new SourceGrid.Cells.Cell("Hello from Cell 0,0");gridll,0 = new SourceGrid.Cells.Cell("Hello from Cell l,0");gridl0,l = new SourceGrid.Cells.Cel
