对数据窗口的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
利用以上代码,可以准确地告诉用户更新了多少条记录,新增了多少条记录。这样用户可以更加清楚自己的操作。

 

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值