?? pbhspage8.htm
字號:
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="GENERATOR" content="Microsoft FrontPage 4.0">
<meta name="ProgId" content="FrontPage.Editor.Document">
<title>Clipboard</title>
<style type="text/css">
<!--
td { font-family: "宋體", "Arial", "MS Sans Serif"; font-size: 9pt}
body { font-family: "宋體", "Arial", "MS Sans Serif"; font-size: 9pt}
.mytd { line-height: 13pt}
a {text-decoration:none}
a:hover {color: red;text-decoration:underline，target="window_name"}
-->
</style>
</head>
<body>
<ul>
<li><b> Clipboard()</b><br>
功能提取或替換Windows系統剪貼板的文本內容。<br>
語法Clipboard ( { string } )<br>
參數string：string類型，可選項，指定要復制到系統剪貼板上的文本。如果剪貼板上已有內容的話，該文本將取代剪貼板的當前內容返回值String。函數執行成功時，如果剪貼板上包含文本數據，那么函數返回剪貼板的當前內容；如果剪貼板上包含非文本數據（比如位圖）或不包含任何數據，那么函數返回空字符串（""）。如果string參數的值為NULL，Clipboard()函數返回NULL。用法無論是否指定string參數，Clipboard()都將返回剪貼板的當前內容。當指定string參數時，剪貼板的原有內容被string參數的值取代；省略string參數時，僅僅得到剪貼板的內容。
<hr>
</li>
<li><b>CommandParm()<br>
</b>功能得到應用程序運行時指定的命令參數。<br>
語法CommandParm ( )<br>
返回值String。函數執行成功時返回應用程序運行時的命令行參數，函數執行錯誤或沒有命令行參數時函數返回空字符串（""）。用法命令行參數是應用程序啟動時跟在應用程序名稱后面的任何參數，比如，在運行窗口中輸入了下述命令：MyAppl C:\EMPLOYEE\EMPLIST.TXT那么MyAppl應用程序中使用CommandParm()函數得到的命令行參數為：C:\EMPLOYEE\EMPLIST.TXT當應用程序的命令行中包含幾個參數時，CommandParm()函數作為一個字符串返回所有參數。利用字符串操作函數可以分離各參數。在應用對象的Open事件中沒有必要執行CommandParm()函數。此時，Open事件的argument參數中包含了命令行參數。
<hr>
</li>
<li><b>DoScript()<br>
</b>功能執行AppleScript程序段，該函數只在Macintosh平臺上有效。<br>
語法DoScript ( script, result )<br>
參數script：string類型，指定要運行的程序段（script）result：string類型，由AppleScript程序段返回的結果信息或出錯信息返回值Integer。返回由AppleScript返回的結果代碼。如果任何參數的值為NULL，DoScript()函數返回NULL。
<hr>
</li>
<li><b>GetApplication()<br>
</b>功能得到當前應用對象的句柄，這樣你可以查詢或設置應用對象的屬性（通常用于編寫通用代碼）。<br>
語法GetApplication ( )<br>
返回值Application。返回當前應用對象的句柄。
<hr>
</li>
<li><b>GetEnvironment()<br>
</b>功能得到操作系統、處理器、屏幕顯示等與系統相關的信息。<br>
語法GetEnvironment ( environmentinfo )<br>
參數environmentinfo：Environment對象名，用于保存系統環境信息返回值Integer。函數執行成功時返回1，發生錯誤時返回-1。如果參數environmentinfo的值為NULL，GetEnvironment()函數返回NULL。用法當開發交叉平臺項目時，利用GetEnvironment()函數，應用程序能夠得到當前運行的操作系統、使用的CPU類型、操作系統的版本、屏幕的大小以及顏色數等信息，這些信息的具體表示請參閱本書環境對象（Environment Object）的介紹。
<hr>
</li>
<li><b>GetFocus()<br>
</b>功能確定當前焦點位于哪個控件上。<br>
語法GetFocus ( )<br>
返回值GraphicObject。函數執行成功時返回當前得到焦點控件的引用，發生錯誤時返回無效引用。用法應用程序利用IsValid()函數可以檢測GetFocus()是否返回有效的控件引用。同時，使用TypeOf()函數可以確定控件的類型。
<hr>
</li>
<li><b> Post()</b><br>
功能將指定消息加入到某個窗口的消息隊列中，這個窗口既可以是PowerBuilder應用的窗口，也可以是其它應用的窗口。<br>
語法Post( handle, messageno, word, long )<br>
參數handle：long類型，指定窗口的系統句柄，將向該窗口郵寄消息messageno：UnsignedInteger類型，指定要郵寄的消息號 word：long類型，指定與消息一起郵寄的word類參數值。如果messageno參數指定的消息不使用該參數，那么將這個參數的值設置為0long：long類型或string，指定與消息一起郵寄的long型參數值或字符串返回值Boolean。如果任何參數的值為NULL，Post()函數返回NULL。<br>
用法Post()函數用于向窗口發送非PowerBuilder預定義事件的消息，這個窗口可以是PowerBuilder應用的窗口，也可以是其它應用的窗口。Post()函數把發送的消息放置在指定窗口消息隊列的尾部，然后返回到應用程序中，它并不等待相應事件事件處理程序的執行。這一點與Send()函數不同，Send()函數直接觸發指定窗口相應的事件，執行事件處理程序后返回到調用應用中。因此，我們說Post()函數采用的是異步方式，Send()函數采用的是同步方式。Post()函數的參數handle指定接收消息的窗口句柄，對PowerBuilder窗口來說，使用Handle()函數可以得到該句柄。對其它應用程序的窗口來說，可以調用系統API函數查找窗口并得到相應窗口的句柄。如果應用程序要郵寄PowerBuilder定義事件（包括預定義事件和用戶定義事件），那么使用PostEvent()函數既簡單有方便。當應用程序在long參數位置指定一個字符串時，Post()函數復制一個該字符串的副本，然后將副本的地址傳送給指定窗口。
<hr>
</li>
<li><b>ProfileInt()<br>
</b>功能從初始化文件（.ini）中讀取整型設置值。<br>
語法ProfileInt ( filename, section, key, default )<br>
參數filename：string類型，指定初始化文件的名稱，可以包括路徑，省略路徑時，該函數按操作系統的標準路徑搜索指定文件section：string類型，指定要得到的值所在的節（Section）key：string類型，指定要得到的值的名稱，不用區分大小寫default：integer類型，當指定的文件、節名、項目名不存在或不能轉換為整數時，函數返回該參數指定的值返回值Integer。函數執行成功時，在指定的文件、節名、項目名不存在任何錯誤的情況下，函數返回相應項的值；如果指定的文件、節名、項目名不存在或不能轉換為整數時，函數返回default參數指定的缺省值。如果發生錯誤，函數返回-1。如果任何參數的值為NULL，ProfileInt()函數返回NULL。
<hr>
</li>
<li><b>ProfileString()<br>
</b>功能從初始化文件（.ini）中讀取字符串型設置值。<br>
語法ProfileString ( filename, section, key, default )<br>
參數filename：string類型，指定初始化文件的名稱，可以包括路徑，省略路徑時，該函數按操作系統的標準路徑搜索指定文件section：string類型，指定要得到的值所在的節（Section）key：string類型，指定要得到的值的名稱，不用區分大小寫default：string類型，當指定的文件、節名、項目名不存在時，函數返回該參數指定的值返回值String。函數執行成功時，在指定的文件、節名、項目名不存在任何錯誤的情況下，函數返回相應項的值；如果指定的文件、節名、項目名不存在，函數返回default參數指定的缺省值。如果發生錯誤，函數返回空字符串。如果任何參數的值為NULL，ProfileString()函數返回NULL。
<hr>
</li>
<li><b>Restart()</b><br>
功能停止所有程序段的執行、關閉所有窗口、提交事務、斷開與數據庫的連接，然后重新啟動應用程序。<br>
語法Restart()<br>
返回值Integer。函數執行成功時返回1，發生錯誤時返回-1。
<hr>
</li>
<li><b> Run()<br>
</b>功能運行指定的應用程序。<br>
語法Run ( string {, windowstate } )<br>
參數string：string類型，指定要運行的應用程序的名稱，其中可以包括路徑以及相應的參數，就像在命令行中鍵入的那樣windowstate：WindowState枚舉類型，可選項，指定程序運行時的窗口狀態。有效取值為：Maximized! - 最大化窗口；Minimized! - 最小化窗口；Normal! - 缺省值，正常窗口返回值Integer。函數執行成功時返回1，發生錯誤時返回-1。如果任何參數的值為NULL，Run()函數返回NULL。<br>
用法使用Run()函數，應用程序能夠啟動操作系統中的任何程序。當在Run()參數中指定了要啟動應用程序的參數時，參數的意義、格式、個數等由具體的應用程序確定。如果在Run()函數的string參數中指定了文件名但沒有給出擴展名時，PowerBuilder認為該文件的擴展名為.EXE。要運行擴展名不是.EXE的應用程序（比如.BAT, .COM, 或.PIF），必須在Run()函數的參數中指定文件的擴展名。
<hr>
</li>
<li><b>Send()</b><br>
功能向窗口發送指定的消息并立即執行相應的事件處理程序。<br>
語法Send( handle, messageno, word, long )<br>
參數handle：long類型，指定窗口的系統句柄，將向該窗口發送消息messageno：UnsignedInteger類型，指定要發送的消息號word：long類型，指定與消息一起發送的word類參數值。如果messageno參數指定的消息不使用該參數，那么將這個參數的值設置為0long：long類型或string，指定與消息一起發送的long型參數值或字符串返回值Long。函數執行成功時返回Windows系統調用SendMessage()的返回值，發生錯誤時返回-1。如果任何參數的值為NULL，Send()函數返回NULL。<br>
用法Send()函數用于向窗口發送非PowerBuilder預定義事件的消息，這個窗口可以是PowerBuilder應用的窗口，也可以是其它應用的窗口。Send()函數直接觸發指定窗口相應的事件，執行事件處理程序后返回到調用應用中，這一點與Post()函數不同，Post()函數把發送的消息放置在指定窗口消息隊列的尾部，然后返回到應用程序中，它并不等待相應事件事件處理程序的執行。因此，我們說Post()函數采用的是異步方式，Send()函數采用的是同步方式。Send()函數的參數handle指定接收消息的窗口句柄，對PowerBuilder窗口來說，使用Handle()函數可以得到該句柄。對其它應用程序的窗口來說，可以調用系統API函數查找窗口并得到相應窗口的句柄。實際上，Send()函數把它的各個參數直接傳送給Windows的系統調用SendMessage()。在各種C++開發工具的WINDOWS.H文件中可以查到各消息編號。如果應用程序要發送PowerBuilder定義事件（包括預定義事件和用戶定義事件），那么使用TriggerEvent()函數既簡單有方便。當應用程序在long參數位置指定一個字符串時，Send()函數復制一個該字符串的副本，然后將副本的地址傳送給指定窗口。
<hr>
</li>
<li><b>SetProfileString()<br>
</b>功能設置初始化文件中指定項的值。<br>
語法SetProfileString ( filename, section, key, value )<br>
參數filename：string類型，指定初始化文件的名稱，可以包括路徑，省略路徑時，該函數按操作系統的標準路徑搜索指定文件section：string類型，指定要設置的值所在的節（Section）key：string類型，指定要設置的值的名稱，不用區分大小寫default：string類型，指定要設置項的值返回值Integer。函數執行成功時返回1，指定的文件未找到或指定的文件不能訪問時函數返回-1。如果任何參數的值為NULL，SetProfileString()函數返回NULL。
<hr>
</li>
<li><b>ShowHelp()</b><br>
功能顯示應用程序幫助，該幫助使用Microsoft Windows幫助系統進行操作。<br>
語法ShowHelp ( helpfile, helpcommand {, typeid } )<br>
參數helpfile：string類型，指定幫助文件的名稱helpcommand：HelpCommand枚舉類型，指定顯示幫助的格式。有效取值為：Index! - 顯示目錄主題，使用該值時不要指定typeid參數；Keyword! - 轉移到由指定關鍵字確定的主題；Topic! - 顯示指定主題的幫助typeid：可選項，指定幫助主題返回值Integer。函數執行成功時返回1，發生錯誤時返回-1。如果任何參數的值為NULL，ShowHelp()函數返回NULL。
<hr>
</li>
<li><b> SignalError()</b><br>
功能觸發應用對象的SystemError事件，通常用于代碼調試。<br>
語法SignalError ( { number }, { text } )<br>
參數number：integer類型，可選項，其值將保存到Error對象的number屬性中text：string類型，可選項，其值將保存到Error對象的text屬性中返回值Integer。函數執行成功時返回1，發生錯誤時返回-1。
<hr>
</li>
<li><b> Yield()<br>
</b>功能將控制權轉移給其它圖形對象，包括非PowerBuilder對象。該函數檢測消息隊列，如果有消息，就把消息取出。利用該函數可以在執行耗時較長的操作時把控制權轉讓給其它應用。<br>
語法Yield()<br>
返回值Boolean。如果在消息隊列中提取到了消息，那么函數返回TRUE，否則返回FALSE。用法正常情況下，PowerBuilder應用程序在執行一段代碼（比如函數或事件處理程序）的過程中不響應用戶的操作。對耗時短暫的代碼段來說，這種處理方式沒有什么不妥的地方，但是，如果某個代碼段的執行耗時較長，應用程序又希望為用戶提供更多的控制權，那么需要在這段代碼中插入Yield()函數，讓用戶能夠進行其它操作，特別在循環執行的代碼中更應該如此。應用程序執行Yield()函數后，如果發現消息隊列中存在消息，它將允許對象處理這些消息，處理之后，繼續Yield()函數后面代碼的執行。因此，代碼中插入Yield()函數將降低應用程序的運行效率。</li>
</ul>
<p> </p>
<p> </p>
<p align="center">PB編程地帶 <font color="#0000FF">版權所有</font></p>
</body>
</html>
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -