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 可視數據窗口檢索數據時引起的編輯控件（指漂浮在數據窗口當前行/列上的編輯控件）重繪操作