PB函数大全六

Open()
功能 打开窗口。该函数有两种语法格式：
语法一、打开编程时已知数据类型的窗口对象；
语法二、打开程序运行后才能确定数据类型的窗口对象。下面分别予以介绍：
语法一、打开编程时已知数据类型的窗口对象
语法Open ( windowvar {, parent } )
参数windowvar：要打开窗口的窗口名，可以使用窗口画笔定义的窗口对象名，也可以使用该窗口对象的某个变量。Open()函数把打开窗口的引用放置到windowvar变量中parent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Open()函数返回NULL。
语法二、打开程序运行后才能确定数据类型的窗口对象
语法Open ( windowvar, windowtype {, parent } )
参数windowvar：指定窗口变量名，Open()函数把打开窗口的引用放置到该变量中windowtype：string类型，指定要打开窗口的数据类型，该参数指定的窗口数据类型必须与windowvar参数的类型相同或是windowvar类型的后继对象parent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Open()函数返回NULL。
OpenSheet()
功能在MDI框架窗口中打开MDI子窗口，并在指定菜单中创建选择该子窗口的菜单项。
语法OpenSheet(sheetrefvar{,windowtype},mdiframe{,position{,arrangeopen}})
参数sheetrefvar：指定要作为工作表打开的窗口名windowtype：string类型，可选项，指定要打开窗口的类型（也就是窗口画笔中保存的窗口对象名）mdiframe：指定要放置工作表的MDI框架窗口名position：可选参数，指定所打开的工作表的名称作为一个菜单项显示在第几个菜单标题下面，缺省时，被放在倒数第二个菜单标题下，原因是，大多数商业软件的最后两个菜单标题是Window和Help，把工作表的名称放到Window菜单标题中用于选择工作表窗口是个合情合理的选择arrangeopen：ArrangeOpen枚举类型，可选参数，但如果选用了此参数，那么position参数也必须同时指定。arrangeopen参数告诉系统如何显示打开的工作表返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数任何的值为NULL，OpenSheet()函数返回NULL。
用法arrangeopen参数的可能取值为：Cascaded!把一个工作表放在另一个的上面，每个都向右下方偏移一点，这样所有工作表的标题栏用户都能看到。该值是OpenSheet()函数的缺省选择。Layered!将工作表显示在客户区的左上角，并最大化工作表，使其充满MDI框架窗口的整个客户区。Original!操作动作与Cascaded!参数相同，只是不放大窗口，而以窗口定义时的大小显示。
OpenSheetWithParm()
功能 在MDI框架窗口中打开MDI子窗口，同时把参数保存在Message对象中进行传递。
语法OpenSheetWithParm(sheetrefvar,parameter{,windowtype},mdiframe{,position{,arrangeopen}}
参数sheetrefvar：指定要作为工作表打开的窗口名parameter：指定要传递给打开工作表的数据，该数据保存在Message对象的属性中， parameter参数的数据类型必须是下述三种类型之一：String、Numeric、PowerObjectwindowtype：string类型，可选项，指定是要打开窗口的类型（也就是窗口画笔中保存的窗口对象名）mdiframe：指定要放置工作表的MDI框架窗口名position：可选参数，指定所打开的工作表的名称作为一个菜单项显示在第几个菜单标题下面，缺省时，被放在倒数第二个菜单标题下，原因是，大多数商业软件的最后两个菜单标题是Window和Help，把工作表的名称放到Window菜单标题中用于选择工作表窗口是个合情合理的选择arrangeopen：ArrangeOpen枚举类型，可选参数，但如果选用了此参数，那么position参数也必须同时指定。arrangeopen参数告诉系统如何显示打开的工作表返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数任何的值为NULL，OpenSheet()函数返回NULL。
用法arrangeopen参数的可能取值为：Cascaded!把一个工作表放在另一个的上面，每个都向右下方偏移一点，这样所有工作表的标题栏用户都能看到。该值是OpenSheet()函数的缺省选择。Layered!将工作表显示在客户区的左上角，并最大化工作表，使其充满MDI框架窗口的整个客户区。Original!操作动作与Cascaded!参数相同，只是不放大窗口，而以窗口定义时的大小显示。
OpenWithParm()
功能带参数打开窗口，与打开窗口的Open()函数相似，OpenWithParm()有两种语法格式：
语法一、带参数打开编程时已知数据类型的窗口对象；
语法二、带参数打开程序运行后才能确定数据类型的窗口对象。下面分别予以介绍：
语法一、带参数打开编程时已知数据类型的窗口对象
语法OpenWithParm(windowvar,parameter{,parent})
参数windowvar：要打开窗口的窗口名，可以使用窗口画笔定义的窗口对象名，也可以使用该窗口对象的某个变量。Open()函数把打开窗口的引用放置到windowvar变量中parameter：指定要传递给打开窗口的数据，该数据保存在Message对象的属性中，parameter参数的数据类型必须是下述三种类型之一：String、Numeric、PowerObjectparent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，OpenWithParm()函数返回NULL。
用法消息对象Message有三个属性用于存储OpenWithParm()函数传递给打开窗口的数据。根据parameter参数数据类型的不同，该参数的值保存在Message对象的不同属性中。
语法二、带参数打开程序运行后才能确定数据类型的窗口对象
语法OpenWithParm(windowvar,parameter,windowtype{,parent})
参数windowvar：指定窗口变量名，Open()函数把打开窗口的引用放置到该变量中parameter：指定要传递给打开窗口的数据，该数据保存在Message对象的属性中，parameter参数的数据类型必须是下述三种类型之一：String、Numeric、PowerObjectwindowtype：string类型，指定要打开窗口的数据类型，该参数指定的窗口数据类型必须与windowvar参数的类型相同或是windowvar类型的后继对象parent：可选项，指定要打开窗口的父窗口，要打开窗口成为父窗口的子窗口，只有当要打开窗口需要成为某个窗口的子窗口时才需要指定该参数。如果应用程序使用Open()函数打开某个子窗口或弹出窗口而又省略了该参数，那么当前活动窗口成为被打开窗口的父窗口返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，OpenWithParm()函数返回NULL。
CloseChannel()
功能关闭先前用OpenChannel()函数打开的DDE服务器的通道。
语法CloseChannel ( handle {, windowhandle } )
参数handle：long类型，通道句柄，指明要关闭的DDE通道windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-2通道不能被关闭-3不能确认服务器-9Handle参数的值为NULL
ExecRemote()
功能请求DDE服务器应用程序执行命令。该函数有两种语法格式：语法一、直接向DDE服务器应用发送一条命令（冷连接方式）；语法二、应用程序打开某个通道后向DDE服务器应用发送命令（热连接方式）。下面分别予以介绍。
语法一、直接向DDE服务器应用发送一条命令（冷连接方式）；
语法ExecRemote ( command, applname, topicname )
参数command：string类型，其值为希望DDE服务器应用执行的命令，命令格式和语法需要参看DDE服务器应用的文档applname：string类型，指定服务器应用的DDE名称topicname：string类型，指定命令中要使用的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝-3不能终止服务器如果任何参数的值为NULL，ExecRemote()函数返回NULL。
语法二、应用程序打开某个通道后向DDE服务器应用发送命令（热连接方式）
语法ExecRemote ( command, handle {, windowhandle } )
参数command：string类型，其值为希望DDE服务器应用执行的命令，命令格式和语法需要参看DDE服务器应用的文档handle：long类型，指定使用的DDE通道句柄windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝-9handle参数的值为NULL
GetDataDDE()
功能从热连接服务器应用中获取数据，并将其保存到指定的字符串变量中。
语法GetDataDDE ( string )
参数string：string类型变量，用于保存接收到的数据返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDE()函数返回NULL。
GetDataDDEOrigin()
功能确定来自热连接DDE服务器应用的数据源，成功时将应用的DDE标识保存在参数指定的变量中。
语法GetDataDDEOrigin ( applstring, topicstring, itemstring )
参数applstring：string类型变量，用于保存服务器应用的名称topicstring：string类型变量，用于保存主题（比如，在Excel中，主题可以是REGION.XLS）itemstring：string类型变量，用于保存数据项标识（比如，在Excel中，数据项标识可以是R1C2）返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，GetDataDDEOrigin()函数返回NULL。
GetRemote()
功能请求服务器应用传送数据，该函数有两种格式：语法一、请求DDE服务器应用提供数据并将数据保存在变量中，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况；语法二、请求DDE服务器应用提供数据并将数据保存在变量中，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。下面分别予以介绍。
语法一、请求DDE服务器应用提供数据并将数据保存在变量中，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况。
语法GetRemote ( location, target, applname, topicname )
参数location：string类型，指明要从DDE服务器的哪个位置返回数据。位置的表达方式由具体的DDE服务器决定target：string类型变量，用于保存返回的数据applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定命令中要使用的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝如果任何参数的值为NULL，GetRemote()函数返回NULL。
语法二、请求DDE服务器应用提供数据并将数据保存在变量中，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。语法GetRemote ( location, target, handle {, windowhandle } )参数location：string类型，指明要从DDE服务器的哪个位置返回数据。位置的表达方式由具体的DDE服务器决定target：string类型变量，用于保存返回的数据handle：long类型，指定使用的DDE通道句柄 windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户。使用handle()函数可以得到窗口句柄。返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝-9Handle参数的值为NULL
OpenChannel()
功能打开连接DDE服务器的通道。
语法OpenChannel ( applname, topicname {, windowhandle } )applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定命令中要使用的DDE应用的数据或实例windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户返回值Long。函数执行成功时返回一个正数作为已打开通道的句柄，发生错误时返回下述值之一：-1打开失败-9句柄为NULL
RespondRemote()
功能发送一条DDE消息，指示是否接受来自远程DDE应用的命令或数据。
语法RespondRemote ( boolean )
参数boolean：其值为boolean量的逻辑表达式，TRUE表示接收先前收到的命令或数据，FALSE表示不接收先前收到的命令或数据返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果boolean参数的值为NULL，RespondRemote()函数返回NULL。
SetRemote()
功能请求服务器应用把指定项设置为指定值。该函数有两种语法格式：语法一、请求DDE服务器应用接收保存在指定位置的数据，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况；语法二、请求DDE服务器应用接收保存在指定位置的数据，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。下面分别予以介绍。
语法一、请求DDE服务器应用接收保存在指定位置的数据，该格式不要求事先打开通道，适用于仅发出少数几个请求的情况。
语法SetRemote ( location, value, applname, topicname )
参数location：string类型，指明要DDE服务器的哪一部分接收数据。位置的表达方式由具体的DDE服务器决定value：string类型变量，指定发送给DDE服务器的数据applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定要接收数据的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝如果任何参数的值为NULL，SetRemote()函数返回NULL。
语法二、请求DDE服务器应用接收保存在指定位置的数据，该格式适用于热连接的情况，即应用程序已经与服务器建立通道。
语法SetRemote ( location, value, handle {, windowhandle } )
参数location：string类型，指明要DDE服务器的哪一部分接收数据。位置的表达方式由具体的DDE服务器决定value：string类型变量，指定发送给DDE服务器的数据handle：long类型，指定使用的DDE通道句柄windowhandle：long类型，可选项，指明用做DDE客户的PowerBuilder窗口的窗口句柄。省略该参数时，当前应用中的活动窗口用做DDE客户返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1未启动连接-2请求被拒绝-9Handle参数的值为NULL
StartHotLink()
功能建立与DDE服务器应用的热连接，热连接建立之后，DDE服务器端相关数据的变化会立即触发PowerBuilder应用相关窗口的HotLinkAlarm事件。
语法StartHotLink ( location, applname, topic )
参数location：string类型，指明DDE服务器哪一部分数据变化时触发窗口的HotLinkAlarm事件。位置的表达方式由具体的DDE服务器决定applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定数据改变将触发窗口的HotLinkAlarm事件的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1无指定服务器-2请求被拒绝如果任何参数的值为NULL，StartHotLink()函数返回NULL。
StopHotLink()
功能关闭与DDE服务器应用的热连接。
语法StopHotLink ( location, applname, topic )
参数location：string类型，指明要终止DDE服务器哪一部分的热连接。位置的表达方式由具体的DDE服务器决定applname：string类型，指定DDE服务器应用的DDE名称topicname：string类型，指定要终止热连接的DDE应用的数据或实例返回值Integer。函数执行成功时返回1，发生错误时返回下述值之一：-1连接未曾启动-2请求被拒绝-3不能终止服务器如果任何参数的值为NULL，StopHotLink()函数返回NULL。 　
CPU()
功能得到自当前应用程序启动后开始CPU所消耗的时间，以毫秒为单位。
语法CPU()
返回值Long。返回自当前应用程序启动后开始CPU所消耗的时间，以毫秒为单位。
Idle()
功能该函数在用户每次活动（例如，按键盘、移动鼠标等）后重置定时器，n秒后触发应用对象的Idle事件。
语法Idle ( n )
参数n：指定空闲时间间隔，以秒为单位。该参数的值设置为0时，停止空闲检测，不再触发应用对象的Idle事件返回值Integer。函数执行成功时返回1，此时启动定时器。如果不能启动定时器或定时器未启动而n的值指定为0时，函数返回-1。如果任何参数的值为NULL，Idle()函数返回NULL。用法利用Idle()函数，应用程序可以构造自己的屏幕保护程序，避免安全数据的泄露。当使用Idle()函数已经启动了定时器后，如果再次以非0参数调用Idle()函数，那么该函数重设时间间隔，但并不启动新的定时器。Idle()函数启动定时器后，如果在指定的时间间隔（从用户最近一次操作算起）内没有操作应用程序，那么就触发应用对象的Idle事件，在这个事件中可以编写关闭窗口、退出数据库登录等一系列代码，然后使用Restart()函数重新启动应用程序，起到保密的目的。发生下述任何情况时，系统自动重置定时器（即重新开始计时）：n 用户在该应用程序的任何窗口内移动鼠标或单击鼠标（双击鼠标时首先触发单击事件）n 在该应用程序的某个窗口是当前窗口时用户按下了任意一个或多个键n 在该应用程序的窗口最小化时，用户在该应用的图标上单击鼠标或移动鼠标n 在该应用程序的窗口最小化并且该应用程序是当前应用程序（应用名称被加亮显示）时，用户按了任何按键n 可视数据窗口检索数据时引起的编辑控件（指漂浮在数据窗口当前行/列上的编辑控件）重绘操作