SourceGrid应用中文帮助

最新推荐文章于 2014-09-28 11:40:22 发布

vainnetwork

最新推荐文章于 2014-09-28 11:40:22 发布

阅读量1w

点赞数

分类专栏： SourceGrid应用文章标签：网格 datagrid string object windows class

本文链接：https://blog.csdn.net/vainnetwork/article/details/1858229

版权

本文详细介绍了SourceGrid控件的使用，包括Grid和GridVirtual控件的基础概念，单元格的操作，如行和列的管理，以及数据绑定和编辑器的使用。SourceGrid控件提供了丰富的单元格类型和编辑器，支持多种自定义功能，适用于大量数据展示和操作的场景。

摘要由CSDN通过智能技术生成

简介：
SourceGrid 是一个免费的完全以 C# 托管代码编写的 .NET Windows 窗体网格控件. SourceGrid 可用于显示或改变表格形式的数据。
SourceGrid 可用于绑定到一个数据源(以 DataView 为代表)，或者直接建立每个单元格。
这种类型的控件有很多可用，但通常需要付费，难于定制或需要面向数据集(DataSet)。
SourceGrid 仅使用托管代码（无API 或 Interop)，可以用于任何与 .NET 2 兼容的环境中。

SourceGrid

简介返回目录

SourceGrid 是一个完全以 C# 托管代码编写的 .NET Windows 窗体网格控件. SourceGrid 可用于显示或改变表格形式的数据。
SourceGrid 可用于绑定到一个数据源(以 DataView 为代表)，或者直接建立每个单元格。
这种类型的控件有很多可用，但通常需要付费，难于定制或需要面向数据集(DataSet)。
SourceGrid 仅使用托管代码（无API 或 Interop)，可以用于任何与 .NET 2 兼容的环境中。

在本文中，我希望对 SourceGrid 控件的一些使用方法和功能进行粗略的介绍。关于该类及其属性、方法更详细的信息，你可以参考 CHM 格式的文档，或者参考在压缩文件中的示例项目
更多的信息，相关的讨论，bug 捕获系统或者需要下载最新的版本，请访问 SourceForge 网页: http://sourceforge.net/projects/sourcegrid ，或者访问我的主页 http://www.devage.com/

快速入门返回目录

安装

要使用 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的工具箱中。

这些程序集是运行时刻所需的，需要随同你的应用程序一起分发给最终用户。

SourceGrid 控件

有 2 种主要的控件包含在 SourceGrid.dll 程序集中:

GridVirtual 控件 - 使用虚单元格(ICellVirtual)的网格控件
Grid 控件 - 使用实体单元格(ICell)的网格控件

因此有 2 种不同的基础对象：虚单元格和实体单元格。虚单元格是确定外观和行为，但不包含值的单元格。实体单元格与虚单元格有相同的属性，但也包含单元格的值，因此在网格中与特定位置相关联。

在不需要显示大量单元格（典型地，应少于50,000 个单元格）时，可以使用任何类型的 Grid 控件。如果需要显示大量单元格，通常你必须使用一个派生于 GridVirtual 的控件，参阅下章获取更多信息。
典型地，在本文中，我将使用 Grid 控件，因为它更简单，尤其是作为简单的示例。但是，同样的代码基本上也能用于 GridVirtual 控件。
Grid 控件也用作需要最大弹性的那些特殊的网格。

拖动 Grid 控件到你的窗体中，就如同添加其它任何 .NET 控件一样，然后开始使用它。

基础示例

目前，SourceGrid 仅有少量的设计时刻支持，因此通常你必须人工编写代码操作网格。
假定你已经有一个名为 grid1 的 Grid 控件，你可以在 Form.Load 事件中编写如下代码:

grid1.BorderStyle = BorderStyle.FixedSingle;
grid1.ColumnsCount = 3;
grid1.FixedRows = 1;
grid1.Rows.Insert(0);
grid1[0,0] = new SourceGrid.Cells.ColumnHeader("String");
grid1[0,1] = new SourceGrid.Cells.ColumnHeader("DateTime");
grid1[0,2] = new SourceGrid.Cells.ColumnHeader("CheckBox");
for (int r = 1; r < 10; r++)
{
    grid1.Rows.Insert(r);
    grid1[r,0] = new SourceGrid.Cells.Cell("Hello " + r.ToString(), typeof(string));
    grid1[r,1] = new SourceGrid.Cells.Cell(DateTime.Today, typeof(DateTime));
    grid1[r,2] = new SourceGrid.Cells.CheckBox(null, true);
}

grid1.AutoSizeCells();

可以看到，你能像使用 2 维数组一样来使用 grid。在上面的代码中，我已经设置了网格的边框，列数，固定行数，建立了一个标头行。对此标头，我使用了一种 ColumnHeader 单元格。我已经为每列使用了特定类型，从而以一种简单的外观建立了其他单元格。Cell 类自动为指定类型建立了一个适当的编辑器（在本例中为一个文本框和一个日期时间选择器）。对最后一列，我使用了一个复选框单元格（CheckBox cell），允许在单元格中直接显示复选框。每种单元格定义了它自己的可视外观和行为。
窗体看起就如下图所显示的一样：

建立的网格支持排序，可改变列宽和编辑单元格。

下面是一些重要的功能：

如果你想读取或改变单元格中的值，可以使用 grid1[r,c].Value 属性， r 和 c 是单元格的行和列。
删除某行，可以编写代码如： grid1.Rows.Remove(r)
改变列宽，可以编写代码如： grid1.Columns[c].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;


grid1[0, 0] = new SourceGrid.Cells.ColumnHeader("String");
grid1[0, 0].View = boldHeader;

grid1[0, 1] = new SourceGrid.Cells.ColumnHeader("DateTime");
grid1[0, 1].View = boldHeader;

grid1[0, 2] = new SourceGrid.Cells.ColumnHeader("CheckBox");
grid1[0, 2].View = boldHeader;
for (int r = 1; r < 10; r++)
{
    grid1.Rows.Insert(r);

    grid1[r, 0] = new SourceGrid.Cells.Cell("Hello " + r.ToString(), typeof(string));
    grid1[r, 0].View = yellowView;

    grid1[r, 1] = new SourceGrid.Cells.Cell(DateTime.Today, typeof(DateTime));
    grid1[r, 1].View = yellowView;

    grid1[r, 2] = new SourceGrid.Cells.CheckBox(null, true);
    grid1[r, 2].View = yellowViewCheck;
}

我使用 FontStyle.Bold | FontStyle.Underline 建立了一个列标头外观，其中标准单元格的外观为黄色背景，复选框单元格的外观为黄色背景。然后我把它们的实例指派到了每个单元格的 View 属性中。
窗体看起来应该像下图所示的一样：

你可以注意到，我已经为许多单元格指派了 View 类的同一个实例。这对于优化所耗用的系统资源是有用的。

每个单元格可以有一个编辑器(Editor 属性) 相关。编辑器用于编辑单元格的值。你可以人工建立一个编辑类(参阅 SourceGrid.Cells.Editors 命名空间)，或者使用 SourceGrid.Cells.Editors.Factory 类建立基于某种类型(Type)的编辑器。如果指定了Type