VC知识库文章 - 一个好用的DBGRID

一个好用的DBGRID --- VC数据库开发之二
作者：

(演示CGridCtrl的使用)
(演示与CMYODBC的配合使用)

一、引言

在用vc开发关于数据库的项目时，通常我们只好用微软的DBGRID作为数据库表格控件，其实微软的DBGRID并不好用，想找一份好的帮助文档都找不到，并且界面并不友好，比起C++Builder中的DBGRID来说是逊色不少，但是DBGRID在开发数据库的项目中又是常用的控件，所以就一直想找一个好用的DBGRID，可是网上又没有找到。上次在无意中看到了CGridCtrl(一个很漂亮的表格控件，如果你还没有用过，可以到下载，上面还有详细的使用说明)支持虚模式，在这种模式下，即使你向这个表格插入一百万条数据，它并不会真的生成一百万行，而是随着你的滚动条的滚动，计算出在屏幕上要显示的行和列，然后会向你提供一个接口，通过这个接口，你可以在这儿设置你要显示的数据。这给了我一些启示，我决定用它来做一个DBGRID。下面的例子是它的一个应用。



二、原理

DBGRID和一般的GRID的不同之处在于，一般的GRID并不适合显示大的数据量，如果你的一个查询结果有上万条记录的话，如果你都要插入到GRID中，这将是一个很慢的过程，并且你在GRID中移动滚动条的话，它的记录的滚动也是很慢的，而DBGRID并不会真正把这些记录的数据全部插入到控件中，当DBGRID的滚动条滚动时，它会根据DBGRID的显示面积的大小和查询得到的总的记录数计算出当前应该显示哪那些行，然后会把那几行的记录数据插入到表格中，这样速度当然是很快的，而且没有数据量多少的限制。

幸运的是，CGridCtrl类已经为我们提供了这种机制，它是采用虚模式的方式，要使用这种方式，按照以下的步骤就可以了：

步骤一　初始化

void SetVirtualMode(TRUE)　设为虚模式
BOOL SetRowCount(int nRows) 设置总的行数。
BOOL SetFixedRowCount(int nFixedRows = 1)设置固定的行数据
BOOL SetColumnCount(int nCols)	设置列数
BOOL SetFixedColumnCount(int nFixedCols = 1)设置固定的列数

步骤二　响应消息　显示数据
我们假设CGridCtrl是放在对话框上，而且它关联的变量是m_Grid,利用ClassWizard添加对话框的OnNotify响应函数。这个响应函数的写法是固定的，类似下面的代码：

BOOL CMyOdbcDlg::OnNotify(WPARAM wParam, LPARAM lParam, LRESULT* pResult) 
{
	if (wParam == (WPARAM)m_Grid.GetDlgCtrlID())
	{
		*pResult = 1;
		GV_DISPINFO *pDispInfo = (GV_DISPINFO*)lParam;
		if (GVN_GETDISPINFO  == pDispInfo->hdr.code)
		{
		/*这是我们自己加的函数，在这个函数里我们设置当前要显示的数据*/
			SetGridItem(pDispInfo);
			return TRUE;
		}
	}
	return CDialog::OnNotify(wParam, lParam, pResult);
}

在上面的代码中，SetGridItem(pDispInfo)是我们自己加的函数，在这个函数里我们设置当前要显示的数据，pDispInfo是一个GV_DISPINFO的结构体对象，在这个结构中包含了每个单元格的信息，如行号，列号，有没有位图，背景色，前景色等，CGRIDCTRL会在当前要显示那个单元格时，会把这个单元格的行号，列号传递给我们，我们只要在里面设置要显示的数据就可以了。如下面是一个显示数据的例子。

int CMyOdbcDlg::SetGridItem(GV_DISPINFO *pDispInfo)
{
	pDispInfo->item.strText.Format("row%d,col%d",pDispInfo->item.row, pDispInfo->item.col);
		 return 0;
}

通过上面的介绍，我们应该已经会使用CGridCtrl虚模式，下面说明一下用CGridCtrl虚模式做DBGRID的原理，大家都知道，MFC的CRecordset类支持多种游标机制，如双向游标的，如果我们是用ClassWizard来生成一个查询的CRecordset的派生类的话，那么可以调用函数CRecordset::SetAbsolutePosition（），用这种方式方式来做DBGRID真是太简单了，因为在上面的int CMyOdbcDlg::SetGridItem(GV_DISPINFO *pDispInfo)函数中，我们已经知道要显示的是哪一行，哪一列的数据，所以只要通过CRecordset::SetAbsolutePosition（pDispInfo->item.row）函数，把游标定位到那一行，然后获取每个字段的数据就可以了。

但是使用上面的方法有一个不好的地方在于，我们必须用ClassWizard为每个查询从CRecordset派生出新类，这样做很不方便，在VC知识库第六期上面有一篇介绍“单独使用CRecordset”文章，可是上面的CRecordset打开方式只能使用CRecordset::forwardOnly，游标只能向前滚动，我们不能使用CRecordset::SetAbsolutePosition（）函数，如果要想使用方便的话，我们必须想别的办法，来提供当前要显示的那个单元格的数据。

我们知道，oracle数据库并不支持双向游标，那么为什么我们用ClassWizard为查询从CRecordset派生的类能够使游标双向移动呢？我的猜想是这样的，CRecordset类其实把每次获取的数据都保存了下来,并且保存了每行记录所在的位置,这样,当我们调用CRecordset::SetAbsolutePosition（）函数时,它就可以得到我们想要的数据了。不管这种猜想对不对，按照上面的思路已经实现一个很好用的DBGRID。我把封装成了类COdbcDBGRIDFILE，它实现的原理是首先得到所查询的行数，列数，然后设置CGridCtrl的属性，如把它设为虚模式，设定CGridCtrl的行数和列数等。然后使用内存映射文件来保存每条记录数据，同时用一个结构体来记录下这条记录所在的位置。

这里有一个小技巧，如果查询的结果有几十万条的话，如果我们一开始就把所有的这些记录都保存在内存映射文件中的话，那么时间要很长，所以根本不能满足应用，所以我们在开始时，只会获取记录集的一部分用于显示，当用户在CGRIDCTRL上拖动滚动条向下滚动时，它会随着用户的滚动不断的获取数据，这样显示上面就一点问题也没有。

三、使用实例

好了，给大家说了这么多，下面就看看如何使用这个封装好的类COdbcDBGRIDFILE 这个类对外的接口只有4个函数可以被调用，下面简单的说明一下这4个函数

COdbcDBGridFILE(CGridCtrl *pGrid = NULL, 
	  	CDatabase *pDatabase = NULL,
		CString strSql = "", 
		CString strFilePath = "");　//构造函数，必须把所要的变量传递进去。
int InitGrid();//初始化函数
int SetGridText(GV_DISPINFO *pDispInfo);//被外部函数调用接口，用来返回每个单元格应该显示的
int Release();//释放资源

按照下面的步骤做一遍，你就能够知道它是不是很实用了。

步骤一
新建一个基于对话框的工程，命名为demo2,打开stdafx.h文件，加入#include，从例子中把OdbcDBGRIDFILE.h, OdbcDBGRIDFILE.cpp复制到这个工程的目录下，并且加入到工程中，方法是菜单project->add to project->files，选择这二个文件就可以了。不要忘了，你要把CGRIDCTRL类的文件都包含进来。

步骤二
在对话框上，按照上面的样例放上一个CURSTOMER CTROL(就是一个人头的那个控件)，在属性的CLASS上输入MFCGridCtrl，ID为IDC_GRIDODBC，然后在放上其它编辑框和按钮控件，为四个编辑框控件通过CLASSWIZARD关联变量

CString	m_strPass;//口令
CString	m_strSource;//数据源名
CString	m_strSql;//查询sql
CString	m_strUser;//用户名

在类CDemo2Dlg中加入下面的几个成员变量

CGridCtrl m_Grid;
COdbcDBGRIDFILE *m_pMapFile;
CImageList m_ImageList;
CDatabase m_db;

当然你要在CDemo2Dlg的声明文件中加入

#include "gridctrl.h"
#include "OdbcDBGRIDFILE.h"

在CDemo2Dlg::DoDataExchange(CDataExchange* pDX)函数中加入DDX_Control(pDX, IDC_GRIDODBC, m_Grid);
在CDemo2Dlg的构造函数中加入

m_pMapFile = NULL;

步骤三
用ClassWizard生成CDemo2Dlg的CDemo2Dlg::OnNotify消息响应函数,在这个函数中，输入如下的代码

BOOL CDemo2Dlg::OnNotify(WPARAM wParam, LPARAM lParam, LRESULT* pResult) 
{
	if (wParam == (WPARAM)m_Grid.GetDlgCtrlID())
	{
		*pResult = 1;
		GV_DISPINFO *pDispInfo = (GV_DISPINFO*)lParam;
		if (GVN_GETDISPINFO  == pDispInfo->hdr.code)
		{
			SetGridItem(pDispInfo);
			return TRUE;
		}
	}
	return CDialog::OnNotify(wParam, lParam, pResult);
}

在上面的代码中，SetGridItem(pDispInfo)是我们自己加的函数，在这个函数里我们设置当前要显示的数据

步骤四
为CDemo2Dlg加入查询按钮的响应函数OnBtnquery()
下面是这个函数的代码

void CDemo2Dlg::OnBtnquery()
 {
		this->Release();/*这个函数用于释放资源的*/
		CString strConn;
	UpdateData(TRUE);
	strConn.Format("ODBC;DSN=%s;UID=%s;PWD=%s",m_strSource,m_strUser, m_strPass);
	    BOOL bResult = m_db.Open(strConn);
	if(bResult == FALSE)
	{
	        return;
	}/*上面的代码用于连接数据库*/
	m_pMapFile = new COdbcDBGRIDFILE(&m_Grid, &m_db, m_strSql, "c:\\csl.txt");
	m_pMapFile->InitGrid();/*初始化函数，用于创建内存映射文件等*/
	}

在上面的代码中，调用了COdbcDBGRIDFILE的构造函数，它的原型是
COdbcDBGRIDFILE::COdbcDBGRIDFILE(CGridCtrl *pGrid , CDatabase *pDatabase, CString strSql, CString strFilePath)，其中的参数的含义如下
CGridCtrl *pGrid-------是一个指向CGridCtrl的指针
CDatabase *pDatabase------是一个指向Cdatabase的指针，你必须把一个已经连接好的Cdatabase的对象传递进去。
CString strSql------是一个查询语句，如select * from emp;
CString strFilePath-----是一个用于生成内存映射文件的文件的路径

步骤五
为CDemo2Dlg加入成员函数SetGridItem(pDispInfo),这个函数是CDemo2Dlg::OnNotify（）中调用的，我们用它来设置显示记录数据。

void CDemo2Dlg::SetGridItem(GV_DISPINFO *pDispInfo)
{
	/*
	在这儿你可自己进行设置，如第一行为查询的字段中文名，
	第一行为行的序号等，如果你不进行设置，那么默认会取每
	个查询得到的字段名，每一行的序号
	*/

	m_pMapFile->SetGridText(pDispInfo);

	/*
	上面的函数只是用来得到了本来，你还可以用它来进行另
	外一些属性，如当超过一定的值是显示DBGRID的不同的前
	景色和前景色等
	*/
}

步骤六
添加成员函数Release(),下面是它的代码，用于释放资源

void CDemo2Dlg::Release()
{
	if(this->m_pMapFile)
	{
		m_pMapFile->Release();
		m_db.Close();
		delete m_pMapFile; m_pMapFile = NULL;
	}
}

在上面的代码中 m_pMapFile->Release()是COdbcDBGRIDFILE的成员函数，用于释放所有的资源。

步骤七
添加对话框的消息响应函数OnClose()，释放所有资源

void CDemo2Dlg::OnClose() 
{
	this->Release();
	CDialog::OnClose();
}

完成好上面的工作，你就可以编译运行了，在上面的编辑框上输入数据源名、用户名、口令和查询的sql语句，你就可以试试效果了，你可以找一张大一点的表，最好有几十万条记录来测试一下，这个DBGRID怎么样。

四、总结

使用这个DBGRID的好处在于我们在查询时，不需要进行先绑定的操作，而且它比微软的DBGRID控件方便多了，希望它能为我们用VC开发数据库项目提高一点效率。如果你看过上一篇文章，用类CMYODBC和CODBCSet来代替MFC的CDatabase和CRecordset的话，那么运行的效率会有很大的提高，我也写了一个相似的类CMyODBCDBGRIDFile，并且用这个类做了一个样例，就是文章篇头提供的配套代码二。

--------------------next---------------------

请问高手，如何在VC源文件中看到每行的行号？ ( 沃野蓝天 发表于 2006-12-6 14:21:00)
 
有一个严重的bug，就是用鼠标点击表格后，在执行查询，刷新表格就会出错！
请问各位有解决的办法么？如果有请发到我的邮箱[e-mail],谢谢 ( hdb198 发表于 2003-7-11 17:14:00)
 
呵呵，请问高手，数据库中有一个字段保存的是图片，
用Chris Maunder的网格控件能显示图片字段吗？
( mll200 发表于 2003-6-16 15:05:00)
 
请教一个问题BOOL CDemo2Dlg::OnNotify(WPARAM wParam, LPARAM lParam, LRESULT* pResult) 
{
// TODO: Add your specialized code here and/or call the base class
    if (wParam == (WPARAM)m_Grid.GetDlgCtrlID())
    {
       *pResult = 1;
        GV_DISPINFO *pDispInfo = (GV_DISPINFO*)lParam;
        if (GVN_GETDISPINFO  == pDispInfo->hdr.code)
        {
SetGridItem(pDispInfo);
return TRUE;
        }
    }
return CDialog::OnNotify(wParam, lParam, pResult);
}
我在*pResult = 1处设置了一个断点，想跟入函数SetGridItem(pDispInfo)看看，可是
在执行if语句后就直接执行return CDialog::OnNotify(wParam, lParam, pResult);了，没

有执行到SetGridItem函数，而我把if语句内的SetGridItem函数注掉后网格内又什么内容都
不显示，请问这是怎么回事呢？

( mll200 发表于 2003-6-16 15:01:00)
 
是非常不错！

要是能实现单元格的合并就更是锦上添花了。 ( dartercq 发表于 2003-6-11 0:25:00)
 
为何与数据库绑定之后，便不能修改cell里的内容了？如何使其能修改？我的信箱是[e-mail]。还请高手们赐教！ ( hdrz 发表于 2003-5-2 15:20:00)
 
对不起，我发现了bug,请在COdbcDBGRIDFILE类的函数
SetGridText(GV_DISPINFO *pDispInfo)的最前面加上下面的代码
if(m_pRowFileInfo == NULL || m_Set.IsEmpty() || m_hFilemap == NULL)//已经被清空的话，那么直接返回
{
pDispInfo->item.strText = "";
return -1;
} ( qish 发表于 2003-4-7 10:33:00)
 
各位！他的数据库用的是ORACLE！！ ( wjmzz 发表于 2003-4-3 16:45:00)
 
我按照第一个例子做下来，最后编译时提示：
Cannot open include file: 'GridCtrl.h': No such file or directory
我应该怎么办 ( 风0 发表于 2003-3-30 20:20:00)
 
谁知道这个控件里，鼠标的当前位置应该如何取得。就是说，当鼠标点下后，如何取得鼠标选择的行的 row ，请不吝赐教。本人邮箱 [e-mail]. ( 追逐流浪的梦 发表于 2003-3-24 9:33:00)
 
.......................................................

--------------------next---------------------