Winform分页控件使用详细介绍

自从上篇随笔《Winform分页控件最新版本发布,并提供基于DotNetBar界面的版本》介绍了最新版本的分页控件,并提供下载使用后,很多人对分页控件非常感兴趣(毕竟Winform数据分页是很常见的),并关注该分页控件应该如何使用,其实分页控件在之前很多篇随笔中断断续续都有介绍,为了使大家对分页控件有个系统的认识,本篇详细介绍分页控件的一些属性设置及相关使用注意事项,使大家对该分页控件有一个更深的了解、跟系统的认识,以便在相关的项目开发中熟练使用。
分页控件效果

 

 

 

实现步骤

 1、在Visual Studio开发环境的工具箱中,添加一个分页控件(可以其他名称)的项目,然后选择WHC.Pager.WinControl.dll文件,导入分页控件的工具箱图标,如下所示。

其中WinGridViewPager和WinGridView两个控件就是我们常用到的分页控件,两者用法几乎一致,界面效果不同在于WinGridViewPager具有分页工具条,而WinGridView是提供显示所有内容,没有工具条。

 

2、拖动到指定的窗体中。

3、在代码引用相关的代码实现动态调用。 

 

实现代码
1、在窗体加载实现中添加分页控件的实现代码,以On开始的是相关操作的实现事件,如OnPageChanged表示分页控件页面发生变化的时候,需要实现的事件处理(这个是必须的),另外AppendedMenu是可以在分页控件自带菜单上增加的菜单,如下所示。注意,只要实现相关的事件处理,那么对应的上下文菜单将会出现,默认几个标准的上下文菜单如下所示,包含新建、编辑选定项、删除选定项、打印列表、刷新列表菜单。
注意,为了使分页控件能够显示总数,并记住当前的分页,那么在OnPageChanged实现中需要修改分页控件的
RecordCount和
CurrenetPageIndex
这两个属性。


如果需要添加自己的菜单,则指定AppendedMenu对象即可。

主要实现代码如下: 

 private void FrmCustomer_Load(object sender, EventArgs e)    

{    
    BindData();    
   
    this.winGridViewPager1.OnPageChanged += new EventHandler(winGridViewPager1_OnPageChanged);    
    
this.winGridViewPager1.OnStartExport += new EventHandler(winGridViewPager1_OnStartExport);    
    
this.winGridViewPager1.OnEditSelected += new EventHandler(winGridViewPager1_OnEditSelected);    
    
this.winGridViewPager1.OnDeleteSelected += new EventHandler(winGridViewPager1_OnDeleteSelected);    
    
this.winGridViewPager1.OnRefresh += new EventHandler(winGridViewPager1_OnRefresh);    
    
this.winGridViewPager1.OnAddNew += new EventHandler(winGridViewPager1_OnAddNew);    
    
this.winGridViewPager1.AppendedMenu = this.contextMenuStrip1;   
}

 

2、其他代码的实现如下所示,包含分页事件、刷新事件、删除事件、编辑事件、新增事件、导出Excel事件等。 

private void winGridViewPager1_OnPageChanged(object sender, EventArgs e)    
{    
    BindData();    
}    
   
private void winGridViewPager1_OnRefresh(object sender, EventArgs e)    
{    
    BindData();    
}    
   
private void winGridViewPager1_OnDeleteSelected(object sender, EventArgs e)    
{    
    
if (MessageUtil.ShowYesNoAndTips("您确定删除选定的记录么?"== DialogResult.No)    
    {    
        
return;    
    }    
   
    DataGridView grid 
= sender as DataGridView;    
    
if (grid != null)    
    {    
        
foreach (DataGridViewRow row in grid.SelectedRows)    
        {    
            BLLFactory
<Customer>.Instance.Delete(row.Cells[0].Value.ToString());    
        }    
        BindData();    
    }    
}    
   
private void winGridViewPager1_OnEditSelected(object sender, EventArgs e)    
{    
    DataGridView grid 
= sender as DataGridView;    
    
if (grid != null)    
    {    
        
foreach (DataGridViewRow row in grid.SelectedRows)    
        {    
            FrmEditCustomer dlg 
= new FrmEditCustomer();    
            dlg.ID 
= row.Cells[0].Value.ToString();    
            
if (DialogResult.OK == dlg.ShowDialog())    
            {    
                BindData();    
            }    
   
            
break;    
        }    
    }    
}    
   
private void winGridViewPager1_OnAddNew(object sender, EventArgs e)    
{    
    btnAddNew_Click(
nullnull);    
}    
   
private void winGridViewPager1_OnStartExport(object sender, EventArgs e)    
{    
    
string where = GetSearchSql();    
    
this.winGridViewPager1.AllToExport = BLLFactory<Customer>.Instance.FindToTable(where);    
}    
   
private void BindData()    
{   
    
#region 添加别名解析    
    
this.winGridViewPager1.AddColumnAlias("ID""编号");    
    
this.winGridViewPager1.AddColumnAlias("Number""客户编号");    
    
this.winGridViewPager1.AddColumnAlias("Name""客户名称");    
    
this.winGridViewPager1.AddColumnAlias("Type""客户类型");    
    
this.winGridViewPager1.AddColumnAlias("Area""客户地区");    
    
this.winGridViewPager1.AddColumnAlias("Company""客户单位");    
    
this.winGridViewPager1.AddColumnAlias("Address""客户地址");    
    
this.winGridViewPager1.AddColumnAlias("Telephone1""电话1");    
    
this.winGridViewPager1.AddColumnAlias("Telephone2""电话2");    
    
this.winGridViewPager1.AddColumnAlias("Telephone3""电话3");    
    
this.winGridViewPager1.AddColumnAlias("Telephone4""电话4");    
    
this.winGridViewPager1.AddColumnAlias("Telephone5""电话5");    
    
this.winGridViewPager1.AddColumnAlias("CreateDate""开户日期");    
    
this.winGridViewPager1.AddColumnAlias("Shop_ID""分店ID");    
    
this.winGridViewPager1.AddColumnAlias("Note""备注");    
    
this.winGridViewPager1.AddColumnAlias("LastUpdated""更新日期");   
    
#endregion    
   
   
    
string where = GetSearchSql();    
    
this.winGridViewPager1.DataSource = BLLFactory<Customer>.Instance.Find(wherethis.winGridViewPager1.PagerInfo);    
    
this.winGridViewPager1.dataGridView1.Refresh();    
}

 

 

3、如果不想把所有的实体类属性或者表字段都显示处理(默认全部显示),那么可以设置属性DisplayColumns即可。
this.winGridViewPager1.DisplayColumns = "ID,ItemNo,ItemName,Manufacture,MapNo,Specification,StockQuantity,AlarmQuantity,WareHouse";   

4、设备报表标题如下所示。 

this.winGridViewPager1.PrintTitle = Portal.gc.gAppUnit + " -- " + "备件信息报表";   

 

5、绑定自定义Datatable对象的实现。

private void BindData()    
{    
    
this.winGridViewPager1.DisplayColumns = "ID,ItemNo,ItemName,Manufacture,MapNo,Specification,Material,ItemBigType,ItemType,
Unit,Price,Source,StoragePos,UsagePos,StockQuantity,AlarmQuantity,Note,Dept,WareHouse";   
    #region 添加别名解析    
   
    
this.winGridViewPager1.AddColumnAlias("ID""编号");    
    
this.winGridViewPager1.AddColumnAlias("ItemNo""项目编号");    
    
this.winGridViewPager1.AddColumnAlias("ItemName""项目名称");    
    
this.winGridViewPager1.AddColumnAlias("Manufacture""供货商");    
    
this.winGridViewPager1.AddColumnAlias("MapNo""图号");    
    
this.winGridViewPager1.AddColumnAlias("Specification""规格型号");    
    
this.winGridViewPager1.AddColumnAlias("Material""材质");    
    
this.winGridViewPager1.AddColumnAlias("ItemBigType""备件属类");    
    
this.winGridViewPager1.AddColumnAlias("ItemType""备件类别");    
    
this.winGridViewPager1.AddColumnAlias("Unit""单位");    
    
this.winGridViewPager1.AddColumnAlias("Price""单价");    
    
this.winGridViewPager1.AddColumnAlias("Source""来源");    
    
this.winGridViewPager1.AddColumnAlias("StoragePos""库位");    
    
this.winGridViewPager1.AddColumnAlias("UsagePos""使用位置");    
    
this.winGridViewPager1.AddColumnAlias("StockQuantity""当前库存");    
    
this.winGridViewPager1.AddColumnAlias("WareHouse""所属库房");    
    
this.winGridViewPager1.AddColumnAlias("Dept""所属部门");    
    
this.winGridViewPager1.AddColumnAlias("Note""备注");   
  
    
#endregion    
   
    
string where = GetConditionSql();    
    List
<ItemDetailInfo> list = BLLFactory<ItemDetail>.Instance.Find(wherethis.winGridViewPager1.PagerInfo);    
    
string tableColumns = "ID|int,ItemNo,ItemName,StockQuantity|int,Manufacture,MapNo,Specification,Material,ItemBigType,ItemType,
Unit,Price|decimal,Source,StoragePos,UsagePos,Note,WareHouse,Dept";    
    DataTable dt = DataTableHelper.CreateTable(tableColumns);    
    DataRow dr 
= null;    
    
foreach (ItemDetailInfo info in list)    
    {    
        dr 
= dt.NewRow();    
        dr[
"ID"= info.ID;    
        dr[
"ItemBigType"= info.ItemBigType;    
        dr[
"ItemName"= info.ItemName;    
        dr[
"ItemNo"= info.ItemNo;    
        dr[
"ItemType"= info.ItemType;    
        dr[
"Manufacture"= info.Manufacture;    
        dr[
"MapNo"= info.MapNo;    
        dr[
"Material"= info.Material;    
        dr[
"Note"= info.Note;    
        dr[
"Price"= info.Price;    
        dr[
"Source"= info.Source;    
        dr[
"Specification"= info.Specification;    
        dr[
"StoragePos"= info.StoragePos;    
        dr[
"Unit"= info.Unit;    
        dr[
"UsagePos"= info.UsagePos;    
        dr[
"WareHouse"= info.WareHouse;    
        dr[
"Dept"= info.Dept;    
   
        StockInfo stockInfo 
= BLLFactory<Stock>.Instance.FindByItemNo(info.ItemNo);    
        
int quantity = 0;    
        
if (stockInfo != null)    
        {    
            quantity 
= stockInfo.StockQuantity;    
        }    
        dr[
"StockQuantity"= quantity;    
        dt.Rows.Add(dr);    
    }    
   
    
this.winGridViewPager1.DataSource = dt.DefaultView;//new WHC.Pager.WinControl.SortableBindingList<ItemDetailInfo>(list);    
    this.winGridViewPager1.PrintTitle = Portal.gc.gAppUnit + " -- " + "备件信息报表";    
}

  

 

下面提供相关分页控件的下载地址:

1、传统界面的的Winform分页控件:http://files.cnblogs.com/wuhuacong/WHC.Pager.WinControl.zip  

2、Dotnetbar界面效果的Winform分页控件:http://files.cnblogs.com/wuhuacong/WHC.Pager.WinControlEx.zip   

 

WInform分页控件的CHM格式帮助文档:http://files.cnblogs.com/wuhuacong/WinformPagerHelp.rar 

 

posted on 2011-07-03 14:24 伍华聪 阅读(...) 评论(...) 编辑 收藏

导航