PB数据窗口控件.docx

1、PB数据窗口控件PB-数据窗口控件数据窗口控件-datawindowPB9.0提供了28个属性、35个默认事件、162个函数。注意与数据窗口对象的区分。【其他】脚本的执行效率*尽量不要在RetrieveRow事件下编写脚本（包括注释）。*如果数据窗口的DoubleClicked事件中编写了脚本，那么在数据窗口的C1icked事件中的脚本应该尽量短，否则双击事件中的脚本永远不可能得到执行。一般来说，Cliked中脚本的执行时间和两次击鼠标之间的间隔时间之和，不应该大于操作系统中所设定的鼠标双击时间间隔，否则双击事件永远不可能触发，双击时仅仅是接连两次触发c1icked事件。*在数据窗口中录入数据

2、时，事件EditChanged是触发频率最高的，每一个按钮都触发该事件；触发频率仅次于该事件的是ItemChanged事件和ItemFocusChanged，只要修改了单元中的内容，每次触发ItemFocusChanged事件都会触发ItemChanged事件。在这些事件下编写过长的脚本会非常影响录入工作的效率。同样，事件RowFocusChanged的触发频率也是相当高的。一般来说是可以避免在这四个事件中编写脚本的。dwo参数使用数据窗口的某些事件中可以使用一个称为dwo的变量，该变量保存数据窗口中的部分信息，用数据窗口的属性可以读取这些信息dwo.type：读取在dwo中保存的对象类型。对

3、象类型可能有bitmap、button、column、compute、graph、groupbox、line、ole、ellipse、rectangle、roundrectangle、report、tableblob、text、datawindow(当用户没有单击特定对象时)dwo.Name：column的列名dwo.Primaryrow：column的数据dwo.Selected：选中column的数据数据缓冲区数据窗口在运行时要创建四个缓冲区，分别是主缓冲区、删除缓冲区、过滤缓冲区和原始缓冲区，这四个缓冲区各司其职、共同配合，来保证数据窗口对数据的正确处理。下面分别加以介绍。1、主缓冲区-

4、Primary这是最重要的一个缓冲区，保存的是当前显示在数据窗口中的所有数据以及它们的修改状态。在保存数据时使用这些状态生成SQL语句。平常的大多数操作都是针对该缓冲区，函数中的缓冲区参数缺省也是该缓冲区。2、删除缓冲区-Delete该缓冲区保存所有删除了的数据。保存数据时，该缓冲区中的数据用来产生delete语句。在数据没有提交到数据库之前，可以从该缓冲区中将数据恢复出来。数据提交后，该缓冲区中的数据清空。3、过滤缓冲区-Filter该缓冲区中保存的是没有通过过滤规则的所有数据，这些数据在存储时同主缓存区的数据一起生成相应的insert或update语句。4、原始缓冲区-original用来

5、保存从数据库中检索到的初始值，在保存数据时用来生成where语句。上面这四个缓冲区中，original缓冲区在脚本中很少使用，其他三个经常涉及到，很多数据窗口函数都需要指定对这三个缓冲区中的哪个进行操作，大多数情况下都使用缺省的缓冲区Primary!。这三个缓冲区，除了保存相应的数据外，都自动维护这些数据的修改标志，它们之间的协作也是自动维护的。例如，当使用过滤函数时，没有通过过滤规则的数据自动从Primary缓存区移送到Filter缓存区；执行删除操作时，数据自动从Primary缓存区移送到Delete缓存区。所有这些数据的移送无需脚本的干预，只管使用相应的函数即可。DWBufferPrim

6、ary! 0Delete! 1Filter! 2DWItemStatusNotModified! 0DataModified! 1New! 2NewModified! 3编辑控件和数据窗口控件打交道都是通过编辑控件进行的。在数据窗口中录入数据、修改数据，实际上是在修改单元上的编辑控件中的内容。当编辑控件移动到另外单元上之前，要对编辑控件中的数据进行校验，如果能通过字段的校验规则，就保存到字段中。编辑控件是可以移动的，需要编辑哪个单元，编辑控件就移动到哪个单元上，接受输入或者修改。编辑控件在没有离开当前字段时，用户录入或者修改的数据就不会被保存到字段中，如何确保在数据窗口失去焦点时，最后位置上编

7、辑框中的内容不被遗漏呢？前面介绍了在数据窗口的LoseFocus事件中编写如下脚本：this.AcceptText()这个方法在很多情况下能解决该问题。美中不足的是，如果编辑框中的内容不能通过字段的校验规则，有时会显示两次错误信息窗口。造成两个错误信息窗口，往往是在选择其他单元时发生，在数据窗口失去焦点之前（如单击“保存”按钮等）只会显示一个错误信息窗口。用户选择其他单元时，编辑框中的数据开始进行校验，不能通过校验规则，显示校验错误信息，在显示校验错误信息时数据窗口失去焦点，触发数据窗口的LoseFocus事件执行AcceptText函数，又一次显示校验错误窗口。所以，显示两次校验错误窗口的原

8、因是LoseFocus事件中的AcceptText函数造成的。可以想法让该函数在这种情况下不执行。为此定义一个实例变量:Boolean ib_accept = True该变量用来表示是否正确通过了校验，然后将LoseFocus中的脚本改成下面的脚本：If ib_accept ThenThis.AcceptText()Elseib_accept = trueEnd If在数据窗口的ItemError事件中编写脚本：ib_accept = False这样就可以解决显示两个校验错误信息窗口了，并且不会遗漏最后一个编辑框中的内容。*当在某个单元中修改或者录入数据后，编辑框要离开时，要进行4个校验步骤，

9、前面两个步骤由PowerBuilder完成，后面两个由开发者编写。(1)看数据和编辑前相比是否发生了改变，没有改变则不做任何处理。(2)检查测试此值是否违反了任何一个在字段上定义的有效性校验规则，违反则拒绝接受此值，并触发ItemError事件。(3)检查此值是否与编辑前真的不同，没有改变则终止有效性校验。(4)检查开发人员在ItemChanged事件中编写的脚本。具体的发生情况取决于分配给被称为动作代码的值。读取和设置数据读取：1、使用函数dw_1.getitemX()2、直接使用数据窗口对象属性来读取数据dw_1.object.data.primary.currentrow,column该

10、语句的格式是：dwcontrol.object.databuffer.whichvaluerow,columndwcontrol是数据窗口控件名称。whichvalue既可以是current（缺省值），也可以是original。这样就允许用户访问一个列的初始值或当前值。row和column是要访问的单元所在的行号及列号。object、data是保留字，buffer是缓存区的名称，有Delete、Primary、Filter。这种引用方法速度比较快，尤其读取大量数据时。设置：使用函数SetItem()SetText()【属性】DataObject数据源Title用来显示在数据窗口的标题条（Tit

11、leBar）上的一个字符串。建议该字符串要有一定的含义，能够标明数据窗口的用途或者其中的数据的类别。该属性的缺省值none。当属性TitleBar为True时，该属性起作用。Visible是否显示数据窗口控件，缺省为True。有时为了向其他数据窗口提供数据，除了使用datastore控件外，还可以使用Visible属性为False的数据窗口。如果仅仅是为了处理数据，不赞成使用Visible属性为False的数据窗口，而应该使用Datastore对象，这样可以节省计算机资源，提高处理效率。Enabled数据窗口控件是否可以获得焦点，缺省为True。可以在脚本中修改该属性以限制用户执行了某些特定操

12、作后再允许操作数据窗口。TitleBar是否显示标题条，缺省为False。使用该属性可以在数据窗口上部显示标题条，类似于窗口的标题条。设置属性为True后，用户就能够拖动数据窗口。ControlMenu是否显示控制菜单，缺省为False。该属性当TitleBar属性为True时才有效。MaxBox和MinBox是否显示最大和最小控制按钮，缺省为False。当属性TitleBar为True时，该属性有效。属性TitleBar和ControlMenu、MinBox、MaxBox共同控制数据窗口的外观是否像窗口的外观。HscrollBar和VscrollBar这两个属性用来控制数据窗口控件的横向和纵

13、向滚动条是否显示。设置为True时，滚动条可以根据需要自动显示，数据够显示时则不出现滚动条。LiveScroll该属性是一个比较重要的属性，缺省为True，表示当拖动垂直滚动滑块时，数据窗口中的行也跟随滚动；属性为False时表示拖动垂直滚动滑块时，数据窗口中的行不跟随滚动，放开垂直滚动滑块后，数据窗口中的数据才滚动到适当数据行上。建议选中该属性，这样当数据很多时，用户就可以拖动垂直滚动小滑块来快速浏览数据了。HsplitScroll该属性是一个非常有实际用途的属性。该属性决定是否显示分割滚动条，缺省为False。当数据窗口比较宽，要显示水平滚动条时，建议将该属性设置为True。RightTo

14、Left该属性为True时表示数据窗口中的所有字符都从右向左显示。缺省为False。当设置该属性为True时，还必须要操作系统的支持，该属性才能起作用。Resizeable用户是否可以调整数据窗口的大小，缺省为False。Border是否显示边框，默认为True，只有在True的情况下BorderStyle才起作用BorderStyle取值为枚举型，用来定义数据窗口边框样式。有四个取值：StyleBox!、StyleLowered!、StyleRaised!、StyleShadowBox!，缺省边框类型为StyleLowered。Icon用来给数据窗口指定标题条左上角的图形，缺省为Window

15、s标志图。【事件】Clicked鼠标左键在数据窗口控件上任意位置单击时触发该事件。该事件中有4个参数，可以在脚本中直接使用。xpos：表示和数据窗口最左侧的距离的整数。ypos：表示和数据窗口最上部的距离的整数，不包括标题条。row：表示用户所单击的行号的long型数。dwo：用户单击对象，是DWObject类型。在该事件的脚本中使用这些参数，可以给用户一些提示信息或者获取用户单击内容的信息。返回值：0表示继续处理，这是缺省值。1表示停止处理。*当选择和当前行不同的数据行时可以触发ItemFocusChanged和RowFocusChanged事件，当单击当前行的其他字段时可以触发ItemFo

16、cusChanged事件。DoubleClicked事件也可以触发该Clicked事件。DBError在数据窗口控件中发生数据库错误时触发该事件。该事件有以下参数。SQLdbcode：long类型的错误代码，具体含义由DBMS指定。当DBMS没有指定错误代码时，SQLdbcode提供4个错误代码，-1表示事务对象参数错误而不能联结到数据库，-2表示不能联结到数据库，-3表示因为其他用户的修改导致用来进行检索或修改的键值在数据库中已经不存在而产生错误，-4表示向数据库中写blob对象时失败。SQLerrtext：string类型，数据库指定的错误信息。SQLsyntax：string类型，当错误

17、发生时，发送到数据库的SQL语句。buffer：DWBuffer枚举型，表示导致错误的数据所在的缓冲区。row：long类型，导致错误的数据的行号。返回值：可以用return语句任意指定返回什么数据。有特定含义的返回值是0和1。0表示显示错误信息，1表示不显示错误信息。DoubleClicked鼠标左键在数据窗口控件中双击时触发该事件。该事件中的4个参数和Clicked事件中的名称及含义完全相同，也可以直接在该事件的脚本中直接使用。该事件的返回值可以用return指定。有特殊函数的返回值是0，表示继续处理。EditChanged在数据窗口控件的编辑框中每次按钮都触发该事件。一般很少在该事件下编

18、写脚本。该事件提供三个参数。row：long类型，当前编辑的行号。dwo：DWObject类型，正在编辑的对象。data：String类型，当前编辑框中的内容。返回值：可以用return指定任意返回值，0表示继续处理。*每次编辑时触发Error当数据窗口对象中的数据或者表达式错误时触发该事件，在分布式系统中联结发生错误时也会触发该事件。和DBError事件不同的是，该事件在没有和数据库交互时就有可能触发，而DBError事件触发时肯定和数据库发生了交互。通常在该事件中编写脚本，提供对错误的处理。该事件提供了很多参数。errornumber：unsigned integer类型，由PowerBu

19、ilder指定的错误代码号。errortext：string类型，由PowerBuilder指定的错误信息。errorwindowmenu：string类型，造成错误的脚本所在对象的父对象的名称。errorobject：string类型，造成错误的脚本所在的对象的名称。errorscript：string类型，造成错误的语句所在的脚本的全部内容。errorline：unsigned integer类型，造成错误的语句在其脚本中所占的行号。action：在Error事件下的代码执行完后，该参数取值由脚本设定。可以指定的值有：ExceptionFail!表示错误处理失败（执行该值有可能触发应用的S

20、ystemError事件）；ExceptionIgnore!表示忽略错误继续执行（要谨慎使用该取值，因为忽略错误有可能将再次导致其他错误）；ExceptionRetry值只能用于OLE，对于数据窗口控件，没有该取值，该取值表示再次执行刚才造成错误的功能；ExceptionSubstituteReturnValue!表示使用参数returnvalue的返回值，而不是返回OLE服务器或数据窗口控件的错误代码，并且取消错误状态。returnvalue：当Action指定为ExceptionSubstituteReturnValue!时返回该参数的取值。*对于数据窗口控件来说，如果在运算数据或属性表达

21、式时发生了错误，将进行如下的错误处理过程：a.触发Error事件；b.如果Error事件中没有脚本或者Action变量设置成ExceptionFail!，则触发应用的SystemError事件；c.如果SystemError事件下也没有脚本，便会发生应用程序错误，然后终止应用程序。所以，在该事件或者应用的SystemError事件下应该编写脚本。这样才不至于退出应用程序，使用户没有处理的机会，甚至录入了半天的数据连个保存的机会也没有了。返回值：该事件没有返回值，也不在该事件中使用return语句。ItemChanged当某单元（行和列的交叉点叫做单元）编辑后(内容改变)，光标要离开时触发该事件

22、，如使用了Enter按钮、单击了Tab按钮、使用了光标键、在其他字段上单击了鼠标左键等。当编辑完一个单元的内容而没有离开该单元，这时数据窗口失去焦点，这种情况不会触发该事件（所以在LoseFocus事件中要使用函数AcceptText）。三个参数row、dwo和data的含义和EditChanged事件的三个参数完全相同。返回值：可以使用return语句返回任意值。0表示接受刚刚修改的数据，该值是缺省值；1表示放弃刚才的修改，不允许焦点离开；2表示放弃刚才的修改，允许焦点离开。*编辑框内容有变化并离开此编辑框时触发；注意：当editchanged事件下有代码，编辑框内容有变化且离开此编辑框时，

23、不会触发此事件ItemError当某单元被编辑后光标要离开时，如果单元中的新数据不能通过有效性校验，则触发该事件。(同ItemChanged：当编辑完一个单元的内容而没有离开该单元，这时数据窗口失去焦点，这种情况不会触发该事件)该事件在ItemChanged事件之前触发，该事件触发就不能再触发ItemChanged事件了。该事件中的三个参数和ItemChanged事件中的三个参数完全相同。返回值：可以使用return语句返回任意数值， 0表示放弃修改的数据，并显示错误信息，焦点不离开该单元，该取值是缺省值；1表示放弃修改的数据但不显示错误信息提示，焦点不离开该单元；2表示接受刚刚修改的错误数据

24、；3表示放弃刚刚修改的数据，并且焦点不离开该单元。ItemFocusChanged当焦点离开某单元时触发该事件(不管内容有没有改变)。该事件提供了row和dwo两个参数，含义和前面介绍的完全相同。可以使用return语句返回任意数值，0表示继续处理。*不管编辑框中的内容有没有改变，离开编辑框时触发该事件，注意：当离开数据窗口时不触发PrintEnd当打印工作完成时触发该事件。参数PagesPrinted可以在脚本中直接使用，是一个long类型的变量，表示已经被打印的页数。PrintPage在数据窗口每页进行打印格式处理之前触发该事件。参数Copy和PageNumber在脚本中可以直接使用，表示

25、该页要打印的份数和当前页的页号。返回值0表示不要跳过当前页，1表示跳过当前页。一般在该事件下编写脚本显示打印进度信息，例如：st_1.text=正在打印第+String(pageNumber)+ 页也可以在该事件中决定是否真正要打印该页。例如，下面的脚本只打印偶数页码的页面：If Mod(pagenumber,2) = 0 Thenreturn 0Elsereturn 1End IfPrintStart数据窗口打印开始时触发该事件。该事件中的参数PagesMax是一个long型变量，表示将要被打印的总页数（不包括跳过的页）。返回0表示继续处理。RetrieveEnd当数据窗口检索完毕时触发该事

26、件。参数rowcount是一个long型变量，表示检索完后检索到的记录数。RetrieveRow每检索到一条记录时都触发该事件。参数row是long类型变量，记录当前检索到的数据的序号。返回值0表示继续检索，1表示停止检索。检索大量数据之前可以设置中断标志，让用户在检索过程中可以停止检索。RetrieveStart当数据窗口的检索操作将要开始时触发该事件，该事件中没有参数。返回值0表示继续执行，该值是缺省值，1表示不执行检索，2表示在检索之前不清除数据行和缓存区。通常不在该事件下编写脚本，即使编写脚本，一般也是利用返回值2的特性来控制检索操作不清除缓存区，这样可以将检索到的数据添加到数据窗口中

27、，并且在数据窗口中保留检索之前的数据。RowFocusChanged当前行改变时触发该事件。CurrentRow参数是一个long类型变量，保存当前记录号。该事件下的典型编程是修改当前行标识，将当前行明显地标识出来，可以让用户清楚地知道要对哪行进行操作，在该事件和其他事件的配合下共同修改当前行标识。*不管内容有没有改变，当前行改变时触发；在离开数据窗口时不触发*RowFocusChanging：当前行改变前触发；参数currentrow触发前所在行，newrow触发后当前行；rowfocuschanged的currentrow等于rowfocuschanging的newrowScrollHor

28、izontal当使用光标键、Tab按钮、滚动条等等在数据窗口中进行水平滚动时触发该事件。很少在该事件上编写脚本。ScrollVertical当在数据窗口中使用光标键、滚动条、Tab键等进行上下滚动时触发该事件。通常在该事件中编写脚本来改变当前行。因为当上下滚动数据窗口时，如果当前行不在当前显示的区域内，则容易给用户造成错觉，可以在该事件中编写脚本将当前页面的第一行数据设置为当前行。使用Describe和Evaluate函数可以实现该功能SQLPreview当执行函数Retrieve、ReselectRow和Update时，SQL语句要提交到DBMS，这时触发该事件。该事件的参数比较复杂。req

29、uest：取值为PreviewFunctionReselectRow!、PreviewFunctionRetrieve! 或PreviewFunctionUpdate!分别代表触发该事件的函数是ReselectRow、Retrieve和Update。 SQLtype：引起该事件的SQL语句类型。取值为PreviewDelete!、PreviewInsert!、PreviewSelect!、PreviewUpdate! 分别表示是Delete 、Insert、Select、Update语句。SQLsyntax：string类型，取值为提交到DBMS的SQL语句。buffer：当前SQL语句所涉及

30、到的数据所在的缓存区，取值为枚举型，Delete!、Filter!、Primary!分别表示删除缓存区、过滤缓存区和主缓存区。row：long类型变量，表示该事件中涉及到的记录数。返回值0表示继续处理，1表示停止处理，2表示处理下一个SQL请求。UpdateEnd当从数据窗口控件发送来的对数据库的修改都完成后触发该事件。该事件的三个参数RowsInserted、RowsUpdated、RowsDeleted都是long类型的变量，分别表示插入、修改和删除的记录数。UpdateStart在调用了update函数之后、开始修改之前触发该事件，该事件没有参数。返回值0表示继续处理，1表示停止修改。L

31、oseFocus数据窗口失去焦点时触发。该事件中编写脚本，主要是保证用户在数据窗口中最后输入的内容不丢失。数据窗口中的输入内容只有当焦点改变时才真正转交给数据窗口，否则只是保存数据窗口的编辑控件。脚本比较简单：this.AcceptText()*GetFocus：数据窗口得到焦点时触发。【函数】SetTransObject语法：dwcontrol.SetTransObject ( transaction )功能：给数据窗口或者datastore控件dwcontrol设置事务对象transaction，缺省事务对象是SQLCA。返回值：成功设置事务对象则返回1，执行过程中发生了错误则返回-1，有任意参数为Null时返回Null。Retrieve语法：dwcontrol.Retrieve ( , argument, argument . . . )功能：使用数据窗口控件的当前事务对象检索数据库中的数据。如果数据窗口控件对应的数据窗口对象定义了检索参数，则应该在该函数中指定检索参数，参数的个数和数据窗口对象的检索变量个数相等，对应的数据类型相兼容。返回值：返回数据窗口控件主缓存区（PrimaryBuffer）中的记录数