SourceGrid介绍和使用及实例举例
先上图，来一个简单演示：
SourceGrid就是一个用于数据显示的表格控件，这个控件比c#自带的
DataGridView要强大很多，先不说他的原理，只说他的功能，可以实现各种自定义样式、嵌入各种控件，如checkbox、Combobox、
Button、超级链接、其他自定义控件等等，另外他不依赖于数据源显示，可以随意控制其显示的单元格；
一，使用方法：
1.1 首先去下载一个SourceGrid控件库，这个是开源控件，下载好后整理一套动态库，放入你的项目里，主要有以下几个：
DevAge.Core.dll //辅助核心
DevAge.Windows.Forms.dll //包装了用于winform里的某些控件的定义
log4net.dll //日志库
SourceGrid.dll //核心库
SourceGrid.Extensions.dll //扩展库
1.2 新建一个winform工程，将这些类库放入debug目录下，然后在工具箱点右键，选择项，点浏览，选择SourceGrid.dll,加入到工具箱；
然后像使用其他控件一样，拖到窗体上；
二，代码的编写；
SourceGrid一般都是以纯代码实现；
2.1首先我们建一个用于数据显示的对象：
public class Student
{
public string Name { get; set; }
public string Gender { get; set; }
public DateTime Birth { get; set; }
public int Fee { get; set; }
}
2.2 增加数据：
定义私有的实例变量：
private List<Student> students = null;
在窗体构造函数里初始化此变量：
students = new List<Student>()
{
new Student(){ Name="张三",Gender="1",Birth=DateTime.Parse("1989-1-1"),Fee = 2500},
new Student(){ Name="李四",Gender="0",Birth=DateTime.Parse("1989-12-10"),Fee = 2200},
new Student(){ Name="王五",Gender="0",Birth=DateTime.Parse("1989-4-4"),Fee = 2800}
};
2.3 在SourceGrid里显示，并统计所收学费总和；
2.3.1 定义方法GetData()
首先初始化列：
SourceGrid.Grid grid = grid1;
grid.BorderStyle = BorderStyle.FixedSingle;
grid.FixedRows = 1;
grid.FixedColumns = 1;
//初始化列
int gridColumnsCount = 5;//设定列数
int gridRowsCount = students.Count+2;//设定行数
int gridWith = this.Width - 20;//设定宽度为当前窗体宽度
int[] colsWidth = { 20, 160, 160, 100, 100 };//每列的宽度
string[] colsText = { "", "姓名", "性别", "生日", "已收学费" };//每列的标题
grid.Rows.Insert(0);
grid.ColumnsCount = gridColumnsCount;
grid.Width = gridWith;
int otherColsWidth = 0;
for (int i = 0; i < 5; i++)
{
SourceGrid.Cells.ColumnHeader head = new SourceGrid.Cells.ColumnHeader(colsText);
head.AutomaticSortEnabled = false;//禁止排序
if (i != grid.ColumnsCount - 1)
{
grid.Columns.Width = colsWidth;
otherColsWidth += colsWidth;
}
else
grid.Columns.Width = grid1.Width - otherColsWidth - 2 * i;//让最后一列铺满整个Grid
grid[0, i] = head;
}
其次，初始化行：
//初始化所有单元格
int rowsReadOnly = gridColumnsCount - 2;//设置某行为只读
for (int i = 0; i <gridRowsCount; i++)
{
int r = grid.RowsCount;
grid.Rows.Insert(r);
for (int j = 1; j < gridColumnsCount;j++ )
{
grid[r, j] = new SourceGrid.Cells.Cell("", typeof(string));
if (i == rowsReadOnly)
{
grid[r, j].Editor = null;
}
}
}
填充数据：
//赋值
int sum = 0;
for (int i = 0; i < students.Count; i++)
{
int r = i + 1;
grid[r, 1] .Value=students.Name;
grid[r, 2] .Value= students.Gender;
grid[r, 3] =new SourceGrid.Cells.Cell(students.Birth, typeof(DateTime));
grid[r, 4] =new SourceGrid.Cells.Cell(students.Fee, typeof(int));
sum += students.Fee;
}
//设置倒数第二行的高度，直接将最后一行挤到最底部；
grid.Rows[grid1.Rows.Count - 2].Height = grid1.Height - grid1.Rows[0].Height * (grid1.RowsCount) + 10;
//设置倒数第一行的内容
grid[grid.Rows.Count - 1, 1] = new SourceGrid.Cells.Cell("总计：", typeof(string));
grid[grid.Rows.Count - 1, 4] = new SourceGrid.Cells.Cell(sum.ToString() + "圆整", typeof(string));
摘录一段网上的描述：
每个单元格由 4 个基本部分组成, 它们基于改进的“模式-外观-控制器(Model-View-Controller)”模型
模式(Model): 模式是管理单元格取值的类, 它包含相关的取值或属性, 并且与其他组件相联系.
外观(View) : 外观是绘制单元格, 并包含可视属性的类.
控制器(Controller) : 控制器是提供单元格行为的类. 编辑器(Editor) :
编辑器是定制单元格的编辑器的类. 这种划分为代码提供了很大的弹性和可重用性, 可节约时间, 为每种定制类型提供可靠的基础。
为了较通用的要求一些类已经被准备和配置, 但是, 可能会需要以某些代码行建立个性化单元格。
简单的理解：
因此，如果想改变外观，就选择或者自定义VIEW，如果想要增加事件、行为，则要选择或者自定义控制器，如果想进去用合适的控件编辑，则要选择或自定义编辑器；
而单元格里面放的是个对象，这个对象可以是普通的单元格、也可以是按钮、也可以是其他类型，等等；
具体的描述性文档可以参照网上的详细介绍：
http://wenku.baidu.com/view/9bde88eb0975f46527d3e156.html
下面给大家列举一个实用的例子
先上图：
实现的功能：
1，自定义列，最后一列铺满整个grid；
2，第0列放一个按钮，单击此按钮可以弹出窗口，选择新窗口的某条记录，记录的结果显示在此行相应的单元格里；
3，性别的选择为下拉列表，且只能是枚举里的值；
4，生日的选择只能为日期，可以弹出日期选择框选择；
5，当前的行用满了，则可以右键增加一行；
6，可以删除选择的行；
相应的代码：
定义几个实例变量：
private int gridRowsCount = 10;//设定行数
private int gridColumnsCount = 5;//设定列数
private int[] colsWidth = { 20, 160, 160, 100, 100 };//每列的宽度
private string[] colsText = { "", "姓名", "性别", "生日", "已收学费" };//每列的标题
定义一个初始化GRID方法，基本都有注解
private void GetGrid()
{
SourceGrid.Grid grid = grid1;
#region 初始化grid
grid.Redim(gridRowsCount, gridColumnsCount);
//选择模式为行
grid.SelectionMode = SourceGrid.GridSelectionMode.Row;
//设置固定列和固定行
grid.FixedColumns = 1;
grid.FixedRows = 1;
//初始化列，最后一列铺满整个grid
for (int i = 0,otherColsWidth = 0; i < gridColumnsCount; i++)
{
SourceGrid.Cells.ColumnHeader head = new SourceGrid.Cells.ColumnHeader(colsText[i]);
head.AutomaticSortEnabled = false;//取消自动排序
if (i != grid.ColumnsCount - 1)//不是最后一列
{
grid.Columns[i].Width = colsWidth[i];
otherColsWidth += colsWidth[i];
}
else //设置最后一列铺满整个grid
grid.Columns[i].Width = grid1.Width - otherColsWidth - 2 * i;
grid[0, i] = head;
}
//初始化行
for (int i = 1; i < gridRowsCount; i++)
{
IniOneRow(i);
}
#endregion
}
其中有个初始化某行，代码见下：
/// <summary>
/// 初始化一行
/// </summary>
/// <param name="rowIndex"></param>
private void IniOneRow(int rowIndex)
{
SourceGrid.Grid grid = grid1;
//单击控制器
SourceGrid.Cells.Controllers.Button buttonClickEvent = new SourceGrid.Cells.Controllers.Button();
buttonClickEvent.Executed += new EventHandler(CellButton_Click);
//下拉框 暂时没用到
//SourceGrid.Cells.Editors.ComboBox cbEditor = new SourceGrid.Cells.Editors.ComboBox(typeof(EnumGender));
//cbEditor.StandardValues = new EnumGender[] { EnumGender.男, EnumGender.女 };
//cbEditor.EditableMode = SourceGrid.EditableMode.Focus |
SourceGrid.EditableMode.SingleClick | SourceGrid.EditableMode.AnyKey;
//日期编辑器
SourceGrid.Cells.Editors.TextBoxUITypeEditor editorDateTime =
new SourceGrid.Cells.Editors.TextBoxUITypeEditor(typeof(DateTime));
PopupMenu menuController = new PopupMenu(this);
for (int j = 0; j < gridColumnsCount; j++)
{
if (j == 0)
{
//单元格设置为按钮
grid[rowIndex, j] = new SourceGrid.Cells.Button("…");
//存放某些必须的信息，如关键字
grid[rowIndex, j].Tag = rowIndex;
//为按钮增加事件
grid[rowIndex, j].AddController(buttonClickEvent);
}
else if (j == 2)
{
//设置为枚举类型，激活之后将会显示为下拉框
grid[rowIndex, j] = new SourceGrid.Cells.Cell(null, typeof(EnumGender));
//grid[i, j].Editor = cbEditor;
//grid[i, j].View = SourceGrid.Cells.Views.ComboBox.Default;
}
else if (j == 3)//日期格式，控制其 显示和输入
{
grid[rowIndex, j] = new SourceGrid.Cells.Cell("", typeof(DateTime));
grid1[rowIndex, j].Editor = editorDateTime;
}
else
grid[rowIndex, j] = new SourceGrid.Cells.Cell("", typeof(string));
//设置每行的激活编辑方式
if (grid[rowIndex, j].Editor!=null)
grid[rowIndex, j].Editor.EditableMode = SourceGrid.EditableMode.Focus | SourceGrid.EditableMode.SingleClick;
//grid[rowIndex, j].Editor.EditableMode =
SourceGrid.EditableMode.Focus | SourceGrid.EditableMode.SingleClick |
SourceGrid.EditableMode.AnyKey;
//为每个行增加右键菜单
grid[rowIndex, j].AddController(menuController);
}
}
这里稍微有点复杂：
1，了解按钮控件如何放单元格里；
2，按钮的事件如何关联
2，了解枚举类型如何处理；
3，如何增加菜单。对于菜单部分，还有部分代码如下：
本帖最后由 繁华都市 于 2013-1-11 10:57 编辑
/// <summary>
/// 按钮单击事件
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void CellButton_Click(object sender, EventArgs e)
{
SourceGrid.CellContext context = (SourceGrid.CellContext)sender;
SourceGrid.Cells.Button btnCell = (SourceGrid.Cells.Button)context.Cell;
string id = btnCell.Tag.ToString();
MessageBox.Show(id);
Student stu = new Student() { Name = "张三", Gender = "1", Birth = DateTime.Parse("1991-1-1"), Fee = 2500 };
EnumGender sGender = stu.Gender == "1" ? EnumGender.男 : EnumGender.女;
int currenRow = btnCell.Row.Index;
grid1[currenRow, 1].Value = stu.Name;
grid1[currenRow, 2].Value = sGender;
grid1[currenRow, 3].Value = stu.Birth;
grid1[currenRow, 4].Value = stu.Fee;
}
下面是菜单的两个操作定义：
/// <summary>
/// 新增一行
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
public void Menu1_Click(object sender, EventArgs e)
{
int i = grid1.RowsCount;
grid1.Rows.Insert(i);
IniOneRow(i);
}
/// <summary>
/// 删除一行
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
public void Menu2_Click(object sender, EventArgs e)
{
//TODO Your code here
int[] rowsIndex = grid1.Selection.GetSelectionRegion().GetRowsIndex();
SourceGrid.RowInfo[] rows = new SourceGrid.RowInfo[rowsIndex.Length];
for (int i = 0; i < rows.Length; i++)
rows = grid1.Rows[rowsIndex【i】];
foreach (SourceGrid.RowInfo r in rows)
grid1.Rows.Remove(r.Index);
if (grid1.RowsCount > 1)
grid1.Selection.FocusRow(1);
}
菜单控制器的定义如下：
public class PopupMenu : SourceGrid.Cells.Controllers.ControllerBase
{
ContextMenu menu = new ContextMenu();
private FormGridEdit mFrm;
public PopupMenu(FormGridEdit frm)
{
mFrm = frm;
menu.MenuItems.Add("新增一行", new EventHandler(mFrm.Menu1_Click));
menu.MenuItems.Add("删除选中的行", new EventHandler(mFrm.Menu2_Click));
}
public override void OnMouseUp(SourceGrid.CellContext sender, MouseEventArgs e)
{
base.OnMouseUp(sender, e);
if (e.Button == MouseButtons.Right)
menu.Show(sender.Grid, new Point(e.X, e.Y));
}
}
性别的枚举：
/// <summary>
/// 枚举，为下拉框准备
/// </summary>
public enum EnumGender
{
男,
女,
无
}