对数据窗口的dwitemstatus研究及应用

对数据窗口的dwitemstatus研究及应用 　　　　

 

引言
pb是由sybase公司推出的一个快速数据库前台开发软件，它以强大的数据窗口技术和数据库访问能力而陪受广大程序员青睐。
在数据窗口中有一个描述数据行和列状态的枚举变量—dwitemstatus,但在实际开发中往往忽视了它的存在。本人根据它的工作机
理和相应的操作函数在实际开发中灵活应用，完善软件产品的功能。
工作机理
dwitemstatus是标示datawindow中的数据行和列修改状态和如何写入数据库中的一个枚举类型变量/这个枚举变量有四个值：
notmodified!,datamodified!,new!,newmodified!。notmodified!表示数据窗口中从数据源中检索出的行数据和列数据没有
发生改变。datmodified!表示数据窗口中从数据源中检索出的行数据和列数据发生了改变。new!表示数据窗口中某一行数据是新
插入而且没有修改过。newmodified!表示数据窗口中某一行数据是新插入但是被修改过。以上所说的修改包括手工输入和用setitem函数设置。
在这四个值中notmodifed!、datamodified!可以表示行和列的状态，但new!和newmodified!只可以表示行的状态。
当数据被检索时：
数据窗口检索到数据以后，所有的行和列的状态被初始化为notmodified!.一旦某一行中的一列数据被手工输入修改或被程序修改后，
这一列的状态变成了datamodified!.一行中只要有一列状态是datamodified!,那这一行状态也就变成datamodified!.
当数据被插入时：
数据窗口中插入一行后，这一行的状态初始化为new!,这一行中的所有列状态被初始化为notmodified!.一旦这一行中的一列数据被手
工输入修改或被程序修改后，这一列的状态变成datamodified!。新插入的一行中只要有一列状态是datamodified!，那这一行状态就变为
newmodified!。如果在数据窗口设计时为某一列设置了默认值，那新插入行时，这一列不会变成datamodified!
生成sql语句：
在数据窗口保存数据时，行的状态就决定了如何生成sql语句。如果行的状态是newmodified!,那就生成insert语句在数据库中插入一
行数据。如果行的状态是datamodified!,那就生成update语句在数据窗口中更新相应数据。
操作函数说明
获取行和列的状态
在程序中可以用数据窗口的getitemstatus方法来获取行或列的状态。函数原形如下：
dwitemstatus dwcontrol.getitemstatus(long row,integer column,dwbuffer dwbuffer)
dwitemstatus dwcontrol.getitemstatus(long row,string column,dwbuffer dwbuffer)
参数说明：
row 获取状态的行。
column 获取状态的列，如果是整行的状态，这个参数设置为0。
dwbuffer 行所在的缓冲区。
返回值：指定行或列的状态枚举值。任一参数为null时，返回null。
改变行或列状态
在程序中可以用数据窗口的setitemstatus方法改变行或列的状态。函数原形如下：
integer dwcontrol.setitemstatus(long row,integer column,dwbuffer dwbuffer,dwitemstatus status)
integer dwcontrol.setitemstatus(long row,string column,dwbuffer dwbuffer,dwitemstatus status)
参数说明：
row 设置状态的行
column 设置状态的列。如果是整行的状态，这个参数设置为0。
dwbuffer 行所在的缓冲区。
status 要设置的新状态。
返回值：如果成功执行返回1，出现错误时返回-1。任一参数为null时，返回null。
调用setitemstatus可以将列的状态由datamodified!,改为notmodified!,反之也可。但是如果想改变行的状态就要麻烦多了，以下是一个行状态
的变换表：
原状态 指定新状态
new! newmodified! datamodified! notmodified!
new! \ yes yes no
newmodified! no \ yes new!
datamodified! newmodified! yes \ yes
notmodified! yes yes yes \
表中的yes意味着改变是可行的。例如将某一行当前状态是notmodified!,调用setitemstatus将行状态改为new!是可以的，改变可以成功。 表中的
no意味着改变是不可行的。例如将某一行当前状态是newmodified!,调用setitemstatus将行状态改为new!是不可以的，改变将不会成功。表中不是yes也
不是no的单元表示改变的具体结果。例如将某一行当前状态是newmodified!,调用setitemstatus将行状态改为nomodified!时，行状态既不是newmodified!，
也不是nomodified!,而是变成了new!。如果某一行的状态变为nomodified!或new!，则这一行的所有列的状态将变为nomodified!。当表中的一些状态改变是
被禁止时，可以分几步来完成这个过程。如：可以先将new!改变为datamodified!，再变为not modified!。
下面举两个实际开发中运用dwitemstatus的例子
例子一：
在实际开发中，为了提醒用户在关闭窗口前保存修改过的数据而在窗口的closequery事件中写如下代码：
int li_ret
if(dw_1.deletedcount()+dw_1.modifiedcount())>0 then
li_ret=messagebox("注意!","数据已经被修改，是否存盘？",question!,yesnocancel!)
if li_ret=1 then
if dw_1.update()=1 then
commit ;
return 0
else
rollback;
messagebox("出错!","存盘时出错！，请检查数据的正确性！")
return 1
end if
elseif li_ret=2 then
return 0
elseif li_ret=3 then
return 1
end if
这样确实可以提醒用户保存数据，但是如果在数据窗口中插入一行后，调用了setitem函数来设置这一行中某些字段的值，即使用户没有做任何的修改，程序也会提醒
用户保存。当出现这种情况时，用户常常感到莫名其妙，不知所措。怎样才能在程序中避免这种情况的出现呢？一个办法就是在调用了setitem后，再用setitemstatus将
新插入行的状态重新设置为notmodified!(对应上表，可知结果为new!),这样在modifiedcount函数对改动数据行进行统计时就不会计入这一行。具体代码如下：
int li_newrow
li_newrow=dw_1.insertrow(0)
dw_1.setitem(li_newrow,"sex",1)
dw_1.setitem(li_newrow,"birth",today())
dw_1.setitem(li_newrow,0,primary!,notmodified!)
例子2：
当用户在保存数据时，为了告诉用户保存了多少条数据，经常在程序中返回sqlca的sqlnrows的值。代码如下：
if dw_1.update()=1 then
li_updatenum=sqlca.sqlnrows
commit using sqlca;
messagebox("","保存了"+string(sqlca.sqlreturndata))+"条记录！")
else
rollback using sqlca;
messagebox("","保存时出现错误，没有数据被保存！")
end if
虽然这样可以告诉用户有多少记录保存，但是这样不是很精确。有时用户想更清楚地知道更新了多少记录，新插入了多少记录，删除了多少记录。这个时候就需要根据
数据行的状态来统计更新了多少记录，新插入了多少记录。具体的办法是在保存前，遍历所有数据行统计newmodified!状态行和datamodified！状态行，前者就是新插入的
数据行，后者就是更新的数据行，再通过deletedcount()函数获取删除的记录数量，详细的代码如下：
int li_newnow=0,li_updaterow=0,li_delrow,i=1
dwitemstatus l_status
dw_1.accepttex()
do while i<=dw_1.rowcount()
l_status=dw_1.getitemstatus(i,0,primary!)
i++
if l_status=datamodified! then
li_updaterow++
elseif l_status=newmodified! then
li_newrow++
end if
loop
li_delrow=dw_1.deletedrow()
if dw_1.update()=1 then
commit using sqlca;
if li_updaterow>0 or li_newrow>0 or li_delrow>0 then
messagebox("提示","保存成功！~n更新了“+string(li_updaterow)+"条记录!~n"&+"新增了"+string(li_newrow)+"条记录!~n"&+"删除了"+string(li_delrow)+"条记录！”）
else
messagebox("提示","没有数据被保存!"
end if
else
rollback using sqlca;
messagebox("提示","保存时出现错误，没有数据被保存!")
end if
利用以上代码，可以准确地告诉用户更新了多少条记录，新增了多少条记录。这样用户可以更加清楚自己的操作。