【導(dǎo)讀】功能定義打印作業(yè)使用的字體，對每個打印作業(yè)PowerBuilder支持八種字體。參數(shù)printjobnumber：用PrintOpen()函數(shù)打開的打印作業(yè)號fontnumber：指定賦給當(dāng)前定義字體的編號，有效值在1到8之間facename：。string類型，指定字體名稱，該字體應(yīng)該是你的打印機支持的字體，比如“宋體”height：Integer類型，使用正值指定字體的高度，以千分之一。英寸為單位；使用負值指定字體點數(shù)，比如，-18代表18點。一般來說，使用點數(shù)更精確些weight：指定字體的磅數(shù)，正常字體為400磅，粗體為700磅fontpitch：FontPitch枚舉類型，指定字體標(biāo)準(zhǔn)。否使用斜體樣式。缺省值為FALSEunderline：boolean類型，指定是否加下劃。缺省值為FALSE返回值Integer。使用更多的字體時，可以在使用了某個字體號輸出內(nèi)容后使用PrintDefineFont()函數(shù)將該字體號對應(yīng)的字體更換為其它字體。功能在當(dāng)前打印頁上繪出指定厚度的一條線。功能在指定位置以指定線寬繪制橢圓或圓。功時返回1，發(fā)生錯誤時返回-1。用法應(yīng)用程序執(zhí)行了PrintRect()函數(shù)后，該函數(shù)并

　　

【正文】 時返回 1，發(fā)生錯誤時返回 1。如果 valuevariable 的數(shù)據(jù)類型與 valuetype 參數(shù)指定的類型不匹配，將引發(fā)運行錯誤。用法 valuetype 的可 能取值為： RegStrin g!以空字符結(jié)束的字符串 RegExpand String!以空字符結(jié)束的字符串，其中包括了對環(huán)境變量的非擴展應(yīng)用 RegBin ary!二進 制數(shù)據(jù) ReguLong!32 位數(shù)據(jù) ReguLongBigEndian!32 位大數(shù)據(jù) RegLink!Unicode 符號鏈 RegMultiString!動態(tài)字符串?dāng)?shù)組為了唯一地標(biāo)識某個鍵， 在 key 參數(shù)中，可以從根鍵開始依次指定各級父鍵，各鍵之間使用反斜杠（ \）分隔。 RegistryValues() 功能得到與指定鍵相關(guān)的一組值名 。該函數(shù)在 Windows 中無效。 語法 RegistryValues ( key, valuename ) 參數(shù) key： string 類型，指定鍵名 valuen am e：字符串?dāng)?shù)組變量，用于保存值名返回值 Integer。函數(shù)執(zhí)行成功時返回 1，發(fā)生錯誤時返回 1。 用法在 valuename 參數(shù)中可以使用定長數(shù)組，也可以使用動態(tài)數(shù)組。使用動態(tài)數(shù)組時，數(shù)組的上界反映了能夠得到的值名個數(shù)。當(dāng)使用定長 數(shù)組時，其數(shù)組元素個數(shù)必須足夠多，保證能夠容納所有值名，但是，在具體得到值名之前，沒有 辦法能夠預(yù)先知道實際值名個數(shù)。為了唯一 地標(biāo)識某個鍵，在 key 參數(shù)中，可以從根鍵開始依次指定各級父鍵，各鍵之間使用反斜杠（ \）分隔。 Clipboard() 功能提取或替換 Windows 系統(tǒng)剪貼板的文本內(nèi)容。 語法 Clipboard ( { string } ) 參數(shù) string： string 類型，可選項，指定要復(fù)制到系統(tǒng)剪貼板上的文本。如果剪貼板上已有內(nèi)容的話，該文本將取代剪貼板的當(dāng)前內(nèi)容返回值 String。函數(shù)執(zhí)行成功時，如果剪貼板上包含文本數(shù)據(jù)，那么函數(shù)返回剪貼板的 當(dāng)前內(nèi)容；如果剪貼板上包含非文本數(shù)據(jù)（比如位圖）或不包 含任何數(shù)據(jù)，那么函數(shù)返回空字符串（ ）。如果 string 參數(shù)的值為 NULL， Clipboard()函數(shù)返回 NULL。用法無論是否指定 string 參數(shù)， Clipboard() 都將返回剪貼板的當(dāng)前內(nèi)容。當(dāng)指定 string 參數(shù)時，剪貼板的原有內(nèi)容被 string 參數(shù)的值取代；省略 string 參數(shù)時，僅僅得到剪貼板的內(nèi)容。 CommandParm() 功能得到應(yīng)用程序運行時指定的命令參數(shù)。 語法 CommandParm ( ) 返回值 String。函數(shù)執(zhí)行成功時返回應(yīng)用程序運行時的命令行參數(shù)，函數(shù)執(zhí)行錯誤或沒有命令行參數(shù)時函數(shù)返回空字符串（ ）。用法命令行 參數(shù)是應(yīng)用程序啟動時跟在應(yīng)用程序名稱后面的任何參數(shù)，比如，在運行窗口中輸入了下述命令： MyAppl C:\EM PLOYEE \EM P 那么 MyAppl 應(yīng)用程序中使用 CommandParm()函數(shù)得到的命令行參數(shù)為： C:\EMPLOYEE\ 當(dāng)應(yīng)用程序的命令行中包含幾個參數(shù)時， CommandParm()函數(shù)作為一個字符串返回所有參數(shù)。利用字符串操作函數(shù)可以分離各參數(shù)。在應(yīng)用對象的 Open 事件中沒有必要執(zhí)行 CommandParm()函數(shù)。此時， Open 事件的 argument 參數(shù)中包含了命令行參數(shù)。 DoScript() 功能執(zhí)行 AppleScript 程序段，該函數(shù)只在 Macintosh 平臺上有效。 語法 DoScript ( script, result ) 參數(shù) script： string 類型 ，指定要運行的程序段（ script） result： string 類型，由 AppleScript 程序段返回的結(jié)果信息或出錯信息返回值 Integer。 返回由 AppleScript 返回的結(jié)果代碼。如果任何參數(shù)的值為 NULL， DoScript()函數(shù)返回 NULL。 GetApplication() 功能得到當(dāng)前應(yīng)用對象的句柄，這樣你可以查詢或設(shè)置應(yīng)用對象的屬性（通常用于編寫通用代碼）。 語法 GetApplication ( ) 返回值 Application。返回當(dāng)前應(yīng)用對象的 句柄。 GetEnvironment() 功能得到操作系統(tǒng)、處理器、屏幕顯示等與系統(tǒng)相關(guān)的信息。 語法 GetEnvironment ( environmentinfo ) 參數(shù) environmentinfo： Environment 對象名，用于保存系統(tǒng)環(huán)境信息返回值 Integer。函數(shù)執(zhí)行成功時返回 1，發(fā)生錯誤時返回 1。如果參數(shù) environmentinfo 的值為 NULL， GetEnvironment()函數(shù)返回 NULL。用法當(dāng)開發(fā)交叉平臺項目時，利用 GetEnvironment()函數(shù)，應(yīng)用程序能夠 得到當(dāng)前運行的操作系統(tǒng)、使用的 CPU 類型、操作系統(tǒng)的版本、屏幕的大小以及顏色數(shù)等信息，這些信息的具體表示請參閱本書環(huán)境對象 （ Environment Object）的介紹。 GetFocus() 功能確定當(dāng)前焦點位于哪個控件上。 語法 GetFocus ( ) 返回值 GraphicO bject。函數(shù)執(zhí)行成功時返回當(dāng)前得到焦點控件的引用，發(fā)生錯誤時返回?zé)o效引用。用法應(yīng)用程序利用 IsValid()函數(shù)可以檢測 GetFocus()是否返回有效的控件引用。同時，使用 TypeOf()函數(shù)可以確定控件的類型。 Post() 功能將指定消息加入到某個窗口的消息隊列中，這個窗口既可以是 PowerBuilder 應(yīng)用的窗口，也可以是其它應(yīng)用的窗口。 語法 Post( handle, messageno, word, long ) 參數(shù) handle： long 類型，指定窗口的系統(tǒng)句柄，將向該窗口郵寄消息 messageno： UnsignedInteger 類型，指定要郵寄的消息號 word： long 類型，指定與消息一起郵寄的 word 類參數(shù)值。如果 messag eno 參數(shù)指定的消息不使用該參數(shù)，那么將這個參數(shù)的值設(shè)置為 0long： lon g 類型 或 string，指定與消息一起郵寄的 long 型參數(shù)值或字符串返回值 Boolean。如果任何參數(shù)的值為 NULL， Post()函數(shù)返回 NULL。 用法 Post()函數(shù)用于向窗口發(fā)送非 PowerBuilder預(yù)定義事件的消息，這個窗口可以是 PowerBuilder應(yīng)用的窗口，也可以是其它應(yīng)用 的窗口。 Post() 函數(shù)把發(fā)送的消息放置在指定窗口消息隊列的尾部，然后返回到應(yīng)用程序中，它并不等待相應(yīng)事件事件處理程序的執(zhí)行。這一點與 Send()函數(shù) 不同， Se nd()函數(shù)直接觸發(fā)指定窗口相應(yīng)的事件，執(zhí)行事件處理程序后返回到調(diào)用應(yīng)用中。因此，我們說 Post()函數(shù)采用的是異步方式， S end () 函數(shù)采用的是同步方式。 Post()函數(shù)的參數(shù) handle 指定接收消息的窗口句柄，對 PowerBuilder 窗口來說，使用 Handle()函數(shù)可以得到該句柄。 對其它應(yīng)用程序的窗口來說，可以調(diào) 用系統(tǒng) API 函數(shù)查找窗口并得到相應(yīng)窗口的句柄。如果應(yīng)用程序要郵寄 PowerBuild er 定義事件（包括預(yù)定 義事件和用戶定義事件），那么使用 PostEven t()函數(shù)既簡單有方便。當(dāng)應(yīng)用程序在 long 參數(shù)位置指定一個字符串時， P ost()函數(shù)復(fù)制一個該字 符串的副本，然后將副本的地址傳送給指定窗口。 ProfileInt() 功能從初始化文件（ .ini）中讀取整型設(shè)置值。 語法 ProfileInt ( filename, section, key, default ) 參數(shù) filenam e： strin g 類型，指定初始化文件的名稱，可以包括路徑，省略路徑時，該函數(shù)按操作系統(tǒng)的標(biāo)準(zhǔn)路徑搜索指定文件 section： strin g 類型，指定要得到的值所在的節(jié)（ Section） key： string 類型，指定要得到的值的名稱，不用區(qū)分大小寫 default： integer 類型，當(dāng)指定的文件、 節(jié)名、項目名不存在或不能轉(zhuǎn)換為整數(shù)時，函數(shù)返回該參數(shù)指定的值返回值 Integer。函數(shù)執(zhí)行成功時，在指定的文件、節(jié)名、項目名不存在任 何錯誤的情況下，函數(shù)返回相應(yīng)項的值；如果指 定的文件、節(jié)名、項目名不存在或不能轉(zhuǎn)換為整數(shù)時，函數(shù)返回 default 參數(shù)指定的缺省值。 如果發(fā)生錯誤，函數(shù)返回 1。如果任何參數(shù)的值為 NULL， ProfileInt()函數(shù)返回 NULL。 ProfileString() 功能從初始化文件（ .ini）中讀取字符串型設(shè)置值。 語法 ProfileString ( filename, section, key, default ) 參數(shù) filenam e： strin g 類型，指定初始化文件的名稱，可以包括路徑，省略路徑時，該函數(shù)按操作 系統(tǒng)的標(biāo)準(zhǔn)路徑搜索指定文件 section： strin g 類型，指定要得到的值所在的節(jié)（ Sec tion） key： strin g 類型，指定要得到的值的名稱，不用區(qū)分大小寫 default： string 類型，當(dāng)指定的文件、 節(jié)名、項目名不存在時，函數(shù)返回該參數(shù)指定的值返回值 String。函數(shù)執(zhí)行成功時，在指定的文件、節(jié)名、項目名不存在任何錯誤的情況下， 函數(shù)返回相應(yīng)項的值；如果指定的文件、節(jié)名、項目名不存在，函數(shù)返回 default 參數(shù)指定的缺省值。如 果發(fā)生錯誤，函數(shù)返回空字符串。如 果任何參數(shù)的值為 NULL， ProfileString()函數(shù)返回 NULL。 Restart() 功能停止所有程序段的執(zhí)行、關(guān)閉所有窗口、提交事務(wù)、斷開與數(shù)據(jù)庫的連接，然后重新啟動應(yīng)用程序。 語法 Restart() 返回值 Integer。函數(shù)執(zhí)行成功時返回 1，發(fā)生錯誤時返回 1。 Run() 功能運行指定的應(yīng)用程序。 語法 Run ( string {, windowstate } ) 參數(shù) string： string 類型，指 定要運行的應(yīng)用程序的名稱，其中可以包括路徑以及相應(yīng)的參數(shù)，就像在命令行中鍵入的那樣 windowstate： WindowState 枚舉類型，可選項，指定程序運行時的窗口狀態(tài)。有效取值為： Maximized! 最大化窗口； Minimized! 最小化窗口； Normal! 缺省值，正常窗口返回值 Integer。函數(shù)執(zhí)行成功時返回 1，發(fā)生錯誤時返回 1。如果任何參數(shù)的值為 NULL， Run()函數(shù)返回 NULL。 用法使用 Run()函數(shù)，應(yīng)用程序能夠啟動操作系統(tǒng)中的任何程序。當(dāng)在 Run()參數(shù)中指定了要啟動應(yīng)用程序的參數(shù)時，參數(shù)的意義、格式、個 數(shù)等由具體的應(yīng)用程序確定。如果在 Run()函數(shù)的 string 參數(shù)中指定了文件名但沒有給出擴展名時， PowerBuilder 認(rèn)為該文件的擴展名為 .EXE。 要運行擴展名不是 .EXE 的應(yīng)用程序（比如 .BAT, .COM, 或 .PIF），必須在 Run()函數(shù)的參數(shù)中指定文件的擴展名。 Send() 功能向窗口發(fā)送指定的消息并立即執(zhí)行相應(yīng)的事件處理程序。 語法 Send( handle, messageno, word, long ) 參數(shù) handle： long 類型，指定窗口的系統(tǒng)句柄，將向該窗口發(fā)送消息 messageno： UnsignedInteger 類型，指定要發(fā)送的消息號 word： long 類型，指定與消息一起發(fā)送的 word 類參數(shù)值。如果 messag eno 參數(shù)指定的消息不使用該參數(shù)，那么將這個參數(shù)的值設(shè)置為 0long： lon g 類型 或 string，指定與消息一起發(fā)送的 long 型參數(shù)值或字符串返回值 Long。函數(shù)執(zhí)行成功時返回 Windows 系統(tǒng)調(diào)用 SendMessage()的返 回值，發(fā) 生錯誤時返回 1。如果任何參數(shù)的值為 NULL， Send()函數(shù)返回 NULL。 用法 Send()函數(shù)用于向窗口發(fā)送非 PowerBuilder 預(yù)定義事件的消息，這個窗口可以是 PowerBuilder 應(yīng)用的窗口，也可以是其它應(yīng)用的窗口。 Send()函數(shù)直接觸發(fā)指定窗口相應(yīng)的事件，執(zhí)行事件處理程序后返回到調(diào)用應(yīng)用中，這一點與