PB的数据窗口操作

★SetTransObject

语法：dwcontrol.SetTransObject ( transaction )

功能：给数据窗口或者datastore控件dwcontrol设置事务对象transaction，缺省事务对象是SQLCA。返回值：成功设置事务对象则返回1，执行过程中发生了错误则返回-1，有任意参数为Null时返回Null。

★Retrieve

语法：dwcontrol.Retrieve ( {, argument, argument . . . } )

功能：使用数据窗口控件的当前事务对象检索数据库中的数据。如果数据窗口控件对应的数据窗口对象定义了检索参数，则应该在该函数中指定检索参数，参数的个数和数据窗口对象的检索变量个数相等，对应的数据类型相兼容。

返回值：返回数据窗口控件主缓存区（PrimaryBuffer）中的记录数，如果检索数据时发生错误则返回-1，如果任意参数为Null则返回Null

*该函数的参数和数据窗口对象定义的参数的顺序要相同，类型要兼容。个数不能少于数据窗口对象定义的参数，即可以等于和多于数据窗口对象定义的参数，多的参数忽略。

★DeleteRow

语法：dwcontrol.DeleteRow ( row )

功能：删除数据窗口dwcontrol中的第row行数据，如果row为0则表示删除当前行的数据。

返回值：执行成功则返回1，执行错误则返回-1，如果任意参数为Null则返回Null。

*该函数执行后只是将被删除的数据从数据窗口的主缓存区移放到Deleted缓冲区，在数据库中并没有真正删除数据，当正确执行了Update函数并且使用commit语句提交了事务后，才真正从数据库中删除该数据

★InsertRow

语法：dwcontrol.InsertRow ( row )

功能：在数据窗口dwcontrol的第row行前插入一行空白数据。当指定row为0时，表示在当前行之前插入一行空白数据。

返回值：返回插入的数据的行号，如果执行过程中发生错误则返回-1，如果任意参数为Null则返回Null

★Update

语法：dwcontrol.Update ( { accept {, resetflag } } )

功能：提交数据窗口或者datastore中的数据。如果accept为True，表示在提交数据之前自动执行AccpetText函数，否则不执行该函数，该参数缺省为True；如果resetflag为True，表示数据提交后自动清除修改标识，该参数缺省为True。

返回值：执行成功则返回1，发生错误则返回-1，如果dwcontrol为Null则返回Null

★AcceptText

语法：dwcontrol.AcceptText ( )

功能：该函数执行时，首先对当前编辑框中的内容进行对应字段的校验规则，能够通过校验规则，则保存在对应字段中，否则显示校验信息提示错误。需要执行该函数的原因是，当在某字段上的编辑框中输入内容而没有移动光标到别的字段上时，其他控件获得焦点，此时编辑框中的内容不能被保存到字段中，所以就应该在数据窗口失去焦点时执行该函数。

返回值：执行成功则返回1，执行过程中发生错误则返回-1，如果dwcontrol为Null则返回Null。

*该函数在数据窗口的ItemChanged事件中不起作用，因为项目改变是发生在接受编辑框中内容之后

★ModifiedCount

语法：dwcontrol.ModifiedCount ( )

功能：获取数据窗口或者Datastore中被修改过但还没有提交到数据库中的记录数。

返回值：返回long类型的数据窗口控件中被修改过的记录数，如果没有记录被修改过或者修改后都已经保存到了数据库中则返回0，执行过程中如果发生错误则返回-1，如果dwcontrol为Null则返回Null。

*该函数获得的修改过的记录数包括主缓存区和Filter缓存区的被修改过的和新添加到数据窗口中的记录数

★DeletedCount

语法：dwcontrol.DeletedCount ( )

功能：获取数据窗口控件或者datastore控件dwcontrol中被删除的记录数。

返回值：返回long类型的已经被删除但还没有提交到数据库中的记录数，如果执行过程中发生了错误则返回-1，如果dwcontrol为Null则返回Null，如果没有删除过记录则返回0

★RowsMove

它可以将数据从一个缓冲区移动到另外缓冲区中。该函数的语法是：

dwcontrol.RowsMove ( startrow, endrow, movebuffer, targetdw, beforerow, targetbuffer ) 其中，dwcontrol是进行移动操作的源数据窗口；startrow和endrow是要移动数据的范围(包括这两个行号的数据)；movebuffer指要从哪个缓存区移出数据，可以是Primary!、Delete!、Filter!；targetdw 是目标数据窗口控件名称；beforerow表示在目标数据窗口的哪一行之前插入移入的数据，如果该数值比目标数据窗口的行数大，则在最后插入移入的数据；targetbuffer是目标缓存区，取值同movebuffer

一样。

★GetItemStatus和SetItemStatus

使用函数dwcontrol.GetItemStatus ( row, column, Primary! )可以获取该缓冲区内指定单元的状态，当参数column为0时，表示读取整个行的修改状态。有以下状态。

NotModified! ：指定单元的数据和原始数据相同，没有修改过。

DataModified!：指定单元的数据和原始数据不同，修改过。

New!：该数据行是新增加的，但还没有在该行上输入数据。

NewModified!：该数据行是新增加的，并且已经在该行上录入了数据。

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

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

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

期望的状态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列的当前状