PB中GetItemStatus和SetItemStatus

DATAWINDOW的四个缓冲区

在PowerBuilder中，DataWindow是用户前端用来存储、操纵数据的对象。在每一个DataWindow对象中有4个二维表作为数据缓冲区，用来存储查询到的数据。用户在DataWindow中对数据处理系统内部的操作实际上都是将数据在这几个缓冲区中进行的修改和移动，最后在用户提交数据库时，系统根据这四个缓冲区中的信息形成SQL的IN-SERT，UPDATE，DELETE等语句。这四个缓冲区是：

1、Primary Buffer

这个缓冲区是存放填充窗口中DataWindow控件中数据的，调用DataWindow的Retrieve()函数和InsertRow()函数可以将数据填入这个缓冲区中。当使用有关DataWindow删除和过滤函数时，相应记录将从这一缓冲区中删除。而在执行DataWindow的Update()函数时，PowerBuilder将查看这一缓冲区中的记录，以形成SQL INSERT和UPDATE语句。

2、Delete Buffer

这个缓冲区保存的是用DeleteRow()函数从Primary Buffer中删除的记录，执行Update()函数时，系统根据这一缓冲区的记录形成DELETE语句。

3、Filter Buffer

这个缓冲区存储的是从Original Buffer使用Filter()函数过滤到Primary Buffer中后剩余的记录。

4、Original Buffer

这一缓冲区存储的是DataWindow最初执行retrieve()函数时得到的全部记录。当提交数据库时，根据Primary Buffer生成的UPDATE语句和根据Delete Buffer生成的DELETE语句都要依据这一缓冲区来构造这些SQL语句中的Where子句。

Original Buffer由PowerBuilder内部维护，Power-Builder所提供的任何函数都无法改变它的值，不过通过PowerBuilder所提供的GetItem…系列的函数可以读出DataWindow最初从数据库中查到的原始值。通过这些函数我们可以编程实现所谓的“Undo”功能，并且得到在使用乐观锁时形成提交数据库的WHERE子句。

如果您当前使用的DataWindow没有设置修改的权力，您将不能对Delete缓冲区和Original缓冲进行操作，而且当调用Update()时也将引起系统错误。

数据缓冲区的状态值

Primary Buffer和Delete Buffer都有行级和列级的状态值，这个状态值是一个枚举类型。在提交时由该行的状态值来决定是否要产生SQL语句，其中Primary Buffer产生的是IN-SERT和UPDATE语句，而Delete Buffer产生的是DELETE语句。我们用GetItemStatus()函数和SetItemStatus()函数可以对这一状态值作操纵。这一枚举状态有以下四种：

◆NotModified!

该行或行的值为查询所得，没有发生改变。

◆DataModified!

该行或列的值为查询所得，发生了改变。

◆New!

该行或列为一插入的新行，数据没有发生改变(数据为空或缺省值)。

◆NewModified!

该行或列为一插入的新行，数据发生改变。改变是通过用户键盘输入或调用了SetItem()函数。

 

 

这些修改标识都是由数据窗口自动维护的，一般情况下没有必要编写脚本修改这些标记，但并不是说就不能修改。PowerBuilder提供了函数SetItemStatus，它的语法是：

dwcontrol.SetItemStatus ( row, column, dwbuffer, status )

其中，row参数指定将要修改状态的行；column参数指定将要修改状态的列（可以是整型的列号，也可以是string类型的列名），当列号为0时表示要修改row指定的整行的状态；dwbuffer指定要修改哪个缓冲区（肯定不能是original），status为上面的四个取值中的一个，但不是任意的取值，因为有些状态不能用该函数设置成另外一种状态，必须是能够转换的状态。表8-1列出了能够转换的状态。 
状态转换 

                                  New!               NewModified!                        DataModified!             NotModified!      
New!                          ——                     Yes                                          Yes                              No
NewModified!            No                        ——                                          Yes                             New!
DataModified!           NewModified!        Yes                                          ——                            Yes
NotModified!             Yes                        Yes                                          Yes                            ——

 

表中的Yes表示可以使用SetItemStatus进行该状态设置，No表示不会产生预期的状态，如果标明了某个特定的状态，则说明是新的状态，而不是期望的状态。例如，数据窗口dw_1的第1行第1列的当前状态为DataModified!，使用函数dw_1.SetItemStatus(1,1,New!)后，第1行第1列的状态改变为NewModified!。同样对于该数据窗口dw_1，如果使用函数dw_1.SetItemStatus(1,1,NotModified!)，则会将其状态改变为NotModified!。当从一种状态不允许转变到另一种状态时，可以修改成其他一个中间状态，然后再进行一次转换。例如，要从new!改成NotModified，应该首先转换到DataModified!。