PB 动态创建数据窗口

    在实际应用中，经常需要根据用户需求来动态创建数据窗，一般方法是这样的。
    在一个window中加入一个数据窗控件，如dw_new,但是该数据窗没有data object,(空白的)就可以用以下语法来创建：
    dw_new.create(ls_syntax,ls_error) // 创建语法，错误信息
    ls_syntax可以用以下三种方法来形成：
    一、动态由sql语法创建：
    // 连接到pb的example数据库
    string ls_sql,ls_syntax,ls_error
    ls_syntax = 'select * from department'
    ls_syntax = sqlca.SyntaxFromSQL(ls_sql,'style(type=grid)',ls_error)
    if len(ls_error) >0 then
      messagebox('Error','SyntaxFromSQL Error:~r'+ls_error)
    else
      dw_new.create(ls_syntax,ls_error)
      if len(ls_error) >0 then
        MessageBox("Error", "Create have these errors: ~r" + ls_error)
      else
        dw_new.settransobject(sqlca)
        dw_new.retrieve()
      end if
    end if
    二、由另一个数据窗的syntax来创建
    string ls_syntax,ls_error
    ls_syntax = dw_test.describe('datawindow.syntax')
    dw_new.create(ls_syntax,ls_error)
    if ls_error  '' then
      messagebox('Create Error',ls_error)
    else
      dw_new.settransobject(sqlca)
      dw_new.retrieve()
    end if
    三、读取psr文件来创建
    string ls_syntax,ls_error,ls_ret
    ls_ret = char(13)+char(10) //回车键
    int li_fileNum
    long li_length
    li_FileNum = FileOpen("efef.psr",Streammode!, read!, shared!, Replace!)
    if li_filenum >0 then
      FileSeek(li_FileNum, 158, FromBeginning!)
      li_length = fileRead(li_filenum,ls_syntax)
    end if
    fileclose(li_filenum)
    if li_length = 0 then return
    ls_syntax = "release 5;"+ls_ret+ls_syntax
    //截掉ls_syntax中的数据部分，5.0以"sparse(names="dept_name?) "作为参考位置
    //6.0以html(作为参考位置
    long pos1,pos2
    pos1 = pos(ls_syntax,'sparse(names="',1)
    pos2 = pos(ls_syntax,'"',pos1 +16)
    ls_syntax = left(ls_syntax,pos1) + mid(ls_syntax,pos1 +1,pos2 - pos1 +1)
    dw_New.create(ls_syntax,ls_error)
    if ls_error  '' then
      messagebox('Create Error',ls_error)
    else
      dw_new.settransobject(sqlca)
      dw_new.retrieve()
    end if
    //pb6,pb7的代码可以参照pb5自己写,只是文件头和数据窗结束标记不同而已。

    PowerBuilder用Create()函数创建动态数据窗口，其语法格式为：dw.Create(Syntax[,ErrString])
    其中：dw为需创建的动态数据窗口名；Syntax为创建动态数据窗口的语法字符串；ErrString为可选参数，用来存放发生错误时的错误信息，若忽
略，发生错误时系统自动显示消息框，一般不符我们需要，所以需定义该参数。
    显然重点在Syntax, PowerBuilder提供LibraryExport()与SyntaxFromSQL()二个函数来达到这个目的：
    一、 LibraryExport()函数
    功能：从PowerBuilder库中输出一个对象，返回该对象的语法。
    语法格式：LibraryExport(LibName,ObjName,ObjType)
    其中：LibName 为带路径的PowerBuilder库名，若未指定路径，则按系统标准搜索路径搜索；ObjName为导出对象名，现为LibName中的数据窗口
对象名；ObjType为该对象的类型，现为数据窗口，值为ExportDataWindow!。示例如下：
    String ls_DwSyntax,ls_Error
    ls_DwSyntax=LibraryExport("C:\PBExam\dy_dw.pbl","d_tbl1", ExportDataWindow!)
    //数据窗口dw_1的产生下面将详细讨论，现暂略
    dw_1.Create(ls_DwSyntax,ls_Error)
    //以下语句与下面示例中的相同，故此处略。
    LibraryExport()函数是利用已有的数据窗口对象创建动态数据窗口，有一定的使用价值，但不多见。
    二、 SyntaxFromSQL()函数
    功能：基于SQL的SELECT 语句产生创建数据窗口的语法。
    语法格式：Transaction.SyntaxFromSQL(SqlString,StyleString,ErrorString)
    其中：Transaction.为已连接的事务对象，一般即为SQLCA；SqlString为SQL--SELECT 语句；Stylestring为数据窗口的显示风格字符串，比较复
杂，一般常用"Style(Type=Grid)"；ErrorString用来存放发生错误时的错误信息。
    一般来说，SyntaxFromSQL()函数灵活性高、功能强，因此创建动态数据窗口大都使用该函数,下面的示例也是使用该函数。
    三、创建动态数据窗口的一般步骤
    创建动态数据窗口的一般步骤如下：
    1、在某窗口（如w_main）上用鼠标点建一个数据窗口控件（如dw_1），其DataObject为空。
    2、构造SyntaxFromSQL()函数的语法字符串。这是PowerBuilder动态数据窗口的关键，稍为复杂一些，具体做法请见下面实例。
    3、用Create()函数创建动态数据窗口dw_1,并用SetTransObject()函数为其分配事务对象，具体做法请见下面实例。
    这种方法的主要缺点是必须在设计阶段先建数据窗口控件，运行时无法增减，这对于一些较为特殊的应用（如设计阶段尚不知需几个数据窗口）
就不太适合了。那如何解决这个问题呢？经过一番摸索并查阅了一些资料，终于找到了二种解决方法，现分别介绍如下：     1、创建一个标准可视数据窗口用户对象u_d_sample
    PowerBuilder6.0/6.5中步骤为：点击工具栏上的UserObject图标，在弹出的Select User Object窗口中点击New按钮，出现New User Object窗口,双击其中Visual下的Standard图标, 在弹出的Select Standard Visual Type窗口中双击datawindow选项，即出现User Object（Untitled）窗口,点击工具栏上的Save图标，弹出的Save User Object窗口,在User Objects: 中输入u_d_sample回车即进入User Object---u_d_sample窗口,关闭该窗口，标准可视数据窗口用户对象u_d_sample即告建成。
    PowerBuilder7.0中步骤为：点击工具栏上的New图标，在弹出的New窗口中选择Object页面，双击其中的Standard Visual图标, 在弹出的Select Standard Visual Type窗口中双击datawindow选项，出现User Object（Untitled）inherited from datawindow窗口,将其右边的Title栏中的none删除，再点击左边空白区，然后点击工具栏上的Save图标，以后的操作步骤与PowerBuilder6.0/6.5大致相同。至于PowerBuilder8.0则与PowerBuilder7.0大体相同，不再赘述。
2、直接定义DataWindow型变量dw_1如下：
    DataWindow dw_1
    dw_1=Create DataWindow
    其实第1种方法还须定义dw_1，形式如下：
    u_d_sample dw_1
    dw_1=Create u_d_ sample //此句可省略
    这二种方法的关键都是使用OpenUserObject()函数,其功能即为打开一个用户对象，语法格式：w_name.OpenUserObject(ObjName[,x,y]) 其中ObjName为需打开的用户对象名；x、y为用户对象的打开位置，省略时值均为0。
    下面请见具体实例, 该实例在Win98、PowerBuilder8.0/PowerBuilder7.0/PowerBuilder6.5下通过,ODBC数据源已配置，为FoxPro25(可根据需要使用其他数据库),数据表为bb.dbf。请先建窗口w_main,在其Open事件中写入以下代码：(注意：PowerBuilder8.0中先须创建WorkSpace(*.pbw),其他操作基本同PowerBuilder7.0)
    //动态数据窗口dw_1创建实例
    string lserr,lsSQLstr,ls_present,ls_syntax
    SQLCA.DBMS="ODBC"
    SQLCA.DBParm="ConnectString='DSN=FoxPro25'" //本例使用FoxPro25数据库,可根据需要用其他数据库
    Connect;
    //下面3条语句即为关键，若dw_1为鼠标点建请删除这3条语句，否则会出错。
    DataWindow dw_1 //若采用数据窗口用户对象u_d_sample，则可改为：u_d_sample dw_1
    dw_1=Create DataWindow //若采用数据窗口用户对象u_d_sample，此句应去除。
    OpenUserObject(dw_1)
    //Select…As…的As可将列标题显示为As之后的字符，较为灵活方便。
    //可根据实际情况设计生成Select语句及Where子句的可视化界面
    lsSQLstr="Select A12 As 主管部门,A01 As 法人代码,mc As 企业名称,A06 From bb Where A120
    ls_present = "style(type=tabular)"
    ls_syntax = SQLCA.SyntaxFromSQL(lsSQLstr, ls_present , lserr)
    
    if len(lserr) > 0 then
       messageBox('Error', ‘Create DW syntax failed! ~r~n’ + lserr)
       return -1
    end if
    dw_1.Create(ls_syntax,lserr) //创建动态数据窗口dw_1
    If Len(lserr)>0 Then
      //如果创建动态数据窗口dw_1失败，则显示错误信息并退出
      messagebox("错误信息!",lserr)
      Return
    end if
    dw_1.SetTransobject(SQLCA)
    dw_1.retrieve( )
    //以下设置dw_1的一些属性，可根据实际需要设置。
    dw_1.X=5
    dw_1.Y=5
    dw_1.width=1500
    dw_1.height=650
    dw_1.Visible=True
    dw_1.Enabled=True
    dw_1.HScrollBar=True
    dw_1.VScrollBar=True
    //为dw_1分配事务对象SQLCA
    dw_1.SetTransObject(SQLCA)
    //提取数据
    dw_1.Retrieve()
    第2种方法的优点大家一看即知，不必费劲去创建一个标准可视数据窗口用户对象，但存在不足之处：不能在窗口w_main的其他事件或控件中引用dw_1。解决方法很简单：将dw_1定义为实例变量（Instance Variable）。PowerBuilder6.0/6.5中：在窗口画笔(w_main)的菜单上点击Declareà Instance Variables…,在弹出窗口Declare Instance Variables中输入datawindow dw_1, 点击Ok按钮即告完成。PowerBuilder7.0/8.0中：打开窗口画笔，在其下半部的窗口Declare Instance Variables中输入datawindow dw_1, 点击工具栏上的Save图标即告完成。