对数据窗口的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 利用以上代码,可以准确地告诉用户更新了多少条记录,新增了多少条记录。这样用户可以更加清楚自己的操作。
|
对数据窗口的dwitemstatus研究及应用
最新推荐文章于 2023-04-20 10:37:41 发布