第16章数据窗口控件.ppt

一、插入行与删除行插入行 1．插入行 InsertRow()函数在数据窗口的主缓冲区中插入一个空行，其语法格式为： Long dwcontrol.InsertRow ( row ) 其中：row是个长整数（long型），它指定插入行的插入位置。 当Row=0：表示在主缓冲区最后一行后面插入一行。即追加一行. 该函数函数执行成功时，返回一个long型值指示插入行的行号，执行失败时返回 -1。 例如：在数据窗口dw_1中插入一行，并让该行成为数据窗口的第10行： dw_1.InsertRow ( 10 ) 2．删除行 DeleteRow()函数在数据窗口的主缓冲区（即显示在用户面前的数据中）中删除一行，语法格式为： dwcontrol.DeleteRow ( row ) 其中： row为要删除行的行号，row等于0时删除当前行。 例如：语句 dw_1.DeleteRow ( 10) 删除数据窗口控件dw_1中的第10行。 DeleteRow ()函数执行成功时返回1，失败时返回-1。 二、将编辑控件数据放到数据窗口列中 前面我们曾经讲到，用户输入数据时，实际上是在编辑控件中输入，该控件框“漂浮”在当前列上面，用户移动输入焦点后，数据窗口把编辑控件中的数据移到列中。 当用户没有移动输入焦点时，怎么把编辑控件中的数据送到列中呢？这就要使用Accepttext()函数了，它告诉数据窗口控件：如果编辑控件中还有数据未检验，那么现在检验它,检验通过后把它放入主缓冲区中。Accepttext()函数的格式为： dwcontrol.AcceptText ( ) 三、得到及设置当前行/列 当前行和当前列是目前正操作的行和列，用户在编辑数据时，也就是正编辑数据项所在的行和列。 1、得到当前行号： long GetRow ( ) 该函数返回一个long型值，表示当前行号。如果没有选中任一行，则返回0，出错时返回-1。 2、得到当前列号 integer dwcontrol.GetColumn ( ) 该函数返回一个integer型值，表示当前列号。返回值为0表示无当前列，返回值为-1表示操作失败。 3、设置某行为当前行 dwcontrol.SetRow ( row ) 把row指定的行设置为当前行。 设置成功时该函数返回1，否则返回-1。如果row的值小于1或大于数据窗口中的总行数，则SetRow ( )函数执行失败。 SetRow ( )函数可能触发下述事件： ItemChanged ItemErrorn ItemFocusChanged RowFocusChanged 四、设置某列为当前列 SetColumn ( )参数column指定的列设置为当前列。 语法格式为： dwcontrol.SetColumn ( column ) 设置成功时该函数返回1，否则返回-1。如果column的值小于1或大于数据窗口中的总列数，则SetColumn ( )函数执行失败。参数column可以是个列号（integer）、也可以是列名（String）。 SetColumn ( )函数可能触发下述事件： ItemChanged ItemErrorn ItemFocusChanged 四、滚动数据行 除了用户直接操作滚动显示在数据窗口中的数据行外，通过编程同样可以滚动数据行。 ScrollToRow()、 ScrollNextRow ( )、 ScrollPriorRow ( )、 ScrollNextPage ( ) ScrollPriorPage ( ) 其它五个函数都可能触发下述事件： ItemChanged ITemError ItemFocusChanged RowFocusChanged 五、清除所有行 Reset ( )函数清除数据窗口中的所有行，语法格式为： dwcontrol.Reset ( ) 该函数执行成功时返回1，否则返回-1。数据窗口在检索数据前自动清除原有数据，因此检索前不需要调用该函数。Reset ( )函数的功能与删除数据窗口的所有行有些差别，执行Reset ( )函数后再执行Update( )函数并不会清除数据库中的数据，而删除数据窗口的所有行后再执行Update( )函数就会清除数据库中的数据。 六、 数据窗口的过滤操作： 使用SetFilter()函数可以在程序中动态修改数据窗口的过滤条件，修改之后，应用程序调用Filter()函数过滤数据。 SetFilter()函数的语法格式为： dwcontrol.SetFilter ( format ) Filter()函数： 其中，format是个字符串，其值是作为过滤条件的逻辑表达式，表达式中可以包括列名或列号。