張瑜
在使用PB進(jìn)行應(yīng)用程序的開發(fā)過程中,除了使用PB提供的函數(shù)之外,我們還可以使用PB之外的函數(shù)和過程,比如動態(tài)連接庫中的函數(shù)、Windows API以及其他的工具軟件包。當(dāng)我們希望給用戶提供一些PB所不能提供的功能時,這時我們就需要使用外部函數(shù)了。 本文以一個廠家提供的DLL文件的實(shí)際操作過程為例來說明如何在程序中調(diào)用外部函數(shù)。例子中動態(tài)連接庫HCOM32.DLL的功能是實(shí)現(xiàn)微機(jī)與某一掌上電腦之間的通訊,本文主要講述此DLL文件中的GetHcSysInfo()函數(shù),該函數(shù)用于實(shí)現(xiàn)讀取掌上電腦的系統(tǒng)信息的功能。
程序的創(chuàng)建步驟如下:
建立應(yīng)用程序 創(chuàng)建一個名為Demo_dll的應(yīng)用程序并存放在“...\ Demo_dll.pbl”中。
創(chuàng)建選單 創(chuàng)建一個名為m_main的主選單,該選單與下面將要創(chuàng)建的主窗體(w_mdihelp)相關(guān)聯(lián), 并且定制了相應(yīng)選單條的工具按鈕,其部分內(nèi)容見表1。 表1 部分選單信息 選單條名稱 功能 m_sysinfo 取掌上電腦的系統(tǒng)信息 m_exit 退出應(yīng)用程序
創(chuàng)建窗體 本實(shí)例共用到兩個窗口,一個主窗體和一個子窗體,它們的具體內(nèi)容見表2,各窗體所包含的控件見表3。 表2 窗體設(shè)置信息 名稱 標(biāo)題 類型 w_mdihelp 外部函數(shù)調(diào)用演示 mdihelp! w_sysinfo 讀取系統(tǒng)信息 popup!
定義結(jié)構(gòu)體變量 由于該外部函數(shù)用到了tempstru類型的結(jié)構(gòu)體變量,因此需要在w_sysinfo窗體中對此結(jié)構(gòu)體變量加以定義。
添加腳本
(1)聲明外部函數(shù) 打開窗口w_sysinfo的腳本編輯器,從對象下拉列表中選擇“Declare”,接著從事件下拉列表中選擇“Local External Functions”,函數(shù)聲明如下: FUNCTION long GetHcSysInfo(long nPort, long nBaudrate, string lpszSysInfoFile, sysinfo_stru lpBuffer) library “HCOM32.DLL” 該函數(shù)的功能是讀取掌上電腦的系統(tǒng)信息,其中參數(shù)的意義分別如下: nPort為通訊端口號,合法值為1-4; nBaudrate為通訊波特率,合法值為115200、38400和9600; lpszSysInfoFile為存放掌上電腦系統(tǒng)信息的文件名; lpBuffer為用來存放系統(tǒng)信息的緩沖區(qū)。 該函數(shù)的返回值為0時表示成功,否則表示出錯。 (2)給Application的Open事件添加如下腳本: if not isvalid(w_mdihelp) then open(w_mdihelp) end if
(3)給選單m_sysinfo的Clicked事件添加如下腳本: opensheet(w_sysinfo,w_mdihelp,1,original!)
(4)給窗體w_sysinfo中的控件cb_open的Clicked事件添加如下腳本: int rtn string pathname, filename rtn=GetFileOpenName ("打開文件",pathname,filename,"txt","Text Files (*.txt),*.txt") if rtn<>1 then messagebox("警告","打開文件出錯,將采用默認(rèn)文件名!",exclamation!) sle_1.text="c:\windows\temp\sys$info.txt" else sle_1.text=pathname end if
(5)給窗體w_sysinfo中的控件cb_ok的Clicked事件添加如下腳本: int rtn string filename sysinfo_stru lpbuffer filename=sle_1.text if filename="" then messagebox("警告","系統(tǒng)信息文件名不能為空,請重新輸入文件名!",exclamation!) return end if rtn=GetHcSysInfo(1,115200,filename,lpbuffer) if rtn<>0 then messagebox("提示","獲取掌上電腦系統(tǒng)信息出錯,原因可能是未與掌上電腦建立連接!") else run("c:\windows\notepad.exe "+filename,normal!) end if close(w_sysinfo)
(6)給窗體w_sysinfo中的控件cb_cancel的Clicked事件添加如下腳本: close(w_sysinfo)
(7)給選單m_exit的Clicked事件添加如下腳本: close(parentwindow)
添加完腳本后,我們就可以運(yùn)行該應(yīng)用程序了。該程序在PowerBuilder 7.0、Windows 98環(huán)境下調(diào)試通過。
表3 窗體包含控件 所屬窗體 控件類型 控件名稱 控件文本 w_mdihelp 主窗體無其他控件,只需連結(jié)主選單即可 w_sysinfo statictext st_1 系統(tǒng)信息文件名 singlelineedit ste_1 commandbutton cb_open commandbutton cb_ok 確定 commandbutton cb_cancel 取消
|