楚琳Web打印控件的使用說明修改版

1、楚琳Web打印控件的使用說明本報表控件為ActiveX控件，通過JavaScript語言進行調(diào)用。本報表控件包 含在PrintActivex.exe文件中，其報表預(yù)覽和打印基本上可以達C/S架構(gòu)的報表效果。本報表控件提供了 ASP, ASP.NET，PHP, JSP語言的示例，用戶可以參照 示例進行開發(fā)。這些示例中核心為三個函數(shù)，為TableToStr、FileToStr、TablePictureToStr 。在實際開發(fā)中，請把此三個函數(shù)拷貝至程序中。TableToStr函數(shù)是把數(shù)據(jù)集的內(nèi)容轉(zhuǎn)化為報表控件所需的XML字符串，對于JSP示例則需要修改一下JavaBean類中所對應(yīng)的連接字符串。F

2、ileToStr函數(shù)是把報表文件或圖片轉(zhuǎn)化為報表控件所需的字符串。TablePictureToStr則把數(shù)據(jù)集中所對應(yīng)的圖片文件轉(zhuǎn)化為報表控件所需的 字符串。報表控件的名稱為WebPrint.WebPrintUnit ，Version屬性為版本號，有此屬性便于用戶自動檢測更新。ReportFileName屬性，用于調(diào)用 DesignReport函數(shù)編輯報表之前，指定報 表的名稱，以便上傳服務(wù)器。Prin terList屬性，獲取客戶端本地已經(jīng)安裝的打印機列表，各打印機名稱之間以“；”分隔。此屬性便于在網(wǎng)頁上設(shè)置指定的打印機進行打?。ˋSP.NET有示例）。Prin ter屬性，可以指定打印時的

3、打印機名稱，對于打印預(yù)覽方式，系統(tǒng)則 把指定打印機設(shè)為首選打印機；對于直接打印，系統(tǒng)則把打印任務(wù)直接分配給指 定打印機。若為空則為默認打印機。指定的打印機必須是客戶端電腦已安裝好的， 本地打印機和網(wǎng)絡(luò)打印機都可以，對于網(wǎng)絡(luò)打印機的名稱，注意“”改為“”，比如：ObjPrintMange.Printer=8Epson LQ-300K;，若指定的打印機不存在，貝U還是默認的打印機。pbPrint屬性，為0則打印預(yù)覽時隱藏按鈕;IpbLoad屬性，為0則打印預(yù)覽時隱藏按鈕；pbSave屬性，為0則打印預(yù)覽時隱藏按鈕；pbExport屬性，為0則打印預(yù)覽時隱藏 按鈕;pbZoom

4、屬性，為0則打印預(yù)覽時隱藏pbFind屬性，為0則打印預(yù)覽時隱藏按鈕;pbOutline屬性，為0則打印預(yù)覽時隱藏 按鈕;pbPageSetup屬性，為0則打印預(yù)覽時隱藏按鈕；pbNavigator屬性，為0則打印預(yù)覽時隱藏按鈕;pbExportQuick屬性，為0則打印預(yù)覽時隱藏按鈕；LeftMargin屬性，設(shè)置頁面設(shè)置的左邊距，單位為毫米；RightMargin屬性，設(shè)置頁面設(shè)置的右邊距，單位為毫米；TopMargin屬性，設(shè)置頁面設(shè)置的上邊距，單位為毫米；BottomMargin屬性，設(shè)置頁面設(shè)置的下邊距，單位為毫米；PageSetURLS性，設(shè)置此屬性，貝恠報表預(yù)覽時，單擊了按鈕，在

5、彈出 的頁面設(shè)置窗口后點擊“確定”按鈕時，通過Http的Post方式直接提交到所設(shè) 置的URL頁面，用戶可以在URL處理用戶所設(shè)置的頁面設(shè)置的左邊距、右邊距、 上邊距、下邊距。Post的字段名指定為 LeftMargin、RightMargin、TopMargin、 BottomMargin，此參數(shù)為用戶所設(shè)置的左邊距、右邊距、上邊距、下邊距。PageSet 屬性的設(shè)置示例：ObjPri ntMa nge.PageSetURL=http:/www.x in /ASPPost/PageSet.asp ?FileName=DepsitAmt.fr3;&UserlD=15;問號后F

6、ileName=DepsitAmt.fr3&UserlD=15 的參數(shù)為用戶指定的參數(shù)，用戶指 定的參數(shù)以Http的Get方式上傳，上傳用戶指定的參數(shù)便于識別。PostURL屬性，設(shè)置此屬性，則在報表在線編輯時，單擊“保存”按鈕或“保 存”菜單項，則把報表內(nèi)容組織為 String，且通過Http的Post方式直接提交 到所設(shè)置的URL頁面，用戶可以在URL接收報表內(nèi)容，把報表內(nèi)容保存在指定文 件或數(shù)據(jù)庫中。Post的字段名指定為ReportFileValue ，用戶可以通過接收此字 段的值保存在線編輯的報表內(nèi)容。報表的內(nèi)容為String，打印或預(yù)覽時可以直接調(diào)用此內(nèi)容，無需用 FileToSt

7、r函數(shù)進行轉(zhuǎn)換。PostURL屬性的設(shè)置示例： ObjPri ntMa nge.PostURL=http:/www.x in /ASPPost/Show.asp?FileN ame=DepsitAmt.fr3; 問號后 FileName=DepsitAmt.fr3 的參數(shù)為用戶指定的參 數(shù)，用戶指定的參數(shù)以Http的Get方式上傳，上傳用戶指定的參數(shù)便于識別。PrintURL屬性，設(shè)置此屬性，則在報表打印時，在彈出的選擇打印機的窗口 后點擊“確定”按鈕時，通過 Http的Post方式直接提交到所設(shè)置的URL頁面， 用戶可以在URL處理用戶已打印的份數(shù)。Post的字段名指定為P

8、rintCopy，此參 數(shù)為用戶打印時所選擇的份數(shù)，默認為1。PrintURL屬性的設(shè)置示例：ObjPri ntMa nge.Pri ntURL=http:/www.x in /ASPPost/Pri ntNum.asp? FileName=DepsitAmt.fr3&UserlD=15;問號后FileName=DepsitAmt.fr3&UserlD=15 的參數(shù)為用戶指定的參數(shù)，用戶指 定的參數(shù)以Http的Get方式上傳，上傳用戶指定的參數(shù)便于識別。DataSetName1 DataSetName2 DataSetName3 DataSetName4 DataSetNam

9、e5DataSetName6屬性，設(shè)置此屬性，則設(shè)置數(shù)據(jù)集的名稱為指定名稱（可以是中 文），否則數(shù)據(jù)集的名稱默認為frxDataSetl至frxDataSet6。注意：若報表編 輯時指定了數(shù)據(jù)集的名稱，則報表預(yù)覽和打印也必須指定相同的數(shù)據(jù)集名稱， 否 則會報錯。CheckReg函數(shù)，功能為檢測注冊，參數(shù)：注冊的公司名稱或個人姓名，注冊 碼。注冊的時候請?zhí)峁┕久Q或個人姓名，作者會把對應(yīng)的注冊碼發(fā)給注冊人， 在每次使用此報表控件時，必須調(diào)用此函數(shù)進行檢測，請輸入注冊時所用的公司 名稱或個人姓名，還有注冊碼。注冊后的報表控件在報表預(yù)覽時會在工具欄的右 上角顯示“某某公司開發(fā)，為注冊版”，打印的時

10、候不會打印此字符串。CheckDoma in Nam函數(shù)，功能為按域名注冊，參數(shù)：注冊的域名、注冊碼。 按域名注冊時，會自動檢測瀏覽器地址上的UR中的域名是否與注冊的域名相符， 若相符，且注冊碼與域名相符，則為已注冊。按域名注冊的打印控件，在報表預(yù) 覽和打印時，都不會顯示注冊信息那一行，這也是和 CheckRegg數(shù)的差別。ShowReport函數(shù)，功能為預(yù)覽報表，參數(shù)：報表文件字符串，報表參數(shù)名稱 字符串，報表參數(shù)值字符串，數(shù)據(jù)集1的字符串，數(shù)據(jù)集2的字符串，數(shù)據(jù)集3的 字符串，數(shù)據(jù)集4的字符串，數(shù)據(jù)集5的字符串，數(shù)據(jù)集6的字符串。報表文件字 符串調(diào)用FileToStr函數(shù)產(chǎn)生；報表參數(shù)名稱

11、字符串為報表中所使用的參數(shù)的名 稱，各名稱之間以分隔；報表參數(shù)值字符串為報表中所使用的參數(shù)所對應(yīng)的值， 各參數(shù)值之間以分隔；數(shù)據(jù)集的字符串通過調(diào)用FileToStr函數(shù)產(chǎn)生，若沒有 數(shù)據(jù)則為空。PrintReport函數(shù)，功能為直接打印報表，參數(shù)和 ShowReport相同。DesignReport函數(shù)，功能為在線編輯報表，參數(shù)和ShowReport相同。編輯好的報表可以通過FTPt傳至服務(wù)器。報表編輯窗口的工具欄上有按鈕，單擊此按鈕，再輸入FTR服務(wù)名、用戶名、密碼和FTP文件夾就可以把報表上傳至服務(wù) 器。若設(shè)置了 PostURLJS性，貝U單擊“保存”時可把報表的內(nèi)容組織為 String，

12、 且通過Http的Post方式直接提交到所設(shè)置的URIX面。MasterOptions函數(shù)，功能為建立主從關(guān)系，參數(shù)：主數(shù)據(jù)集序號，關(guān)聯(lián)字 段名，字段是否為數(shù)值型。此函數(shù)是用于主從報表打印。主數(shù)據(jù)集序號通常為1, 關(guān)聯(lián)字段名為兩個數(shù)據(jù)集共同的字段名，字段名若為數(shù)據(jù)型則為1,否則為0。AddPicturePri nt函數(shù)，功能為增加圖片打印，若為單個圖片的參數(shù)為：報 表中圖片對象名，數(shù)據(jù)表的字段（為0），圖片文件名，數(shù)據(jù)集序號，是否清除 舊數(shù)據(jù)（第1次調(diào)用時為1,其它時候則為0）;若為數(shù)據(jù)表中的圖片打印的參數(shù)： 報表中圖片對象名，數(shù)據(jù)表的字段（為1），圖片文件名所對應(yīng)的字段名，數(shù)據(jù) 集序號，是否

13、清除舊數(shù)據(jù)（第1次調(diào)用時為1,其它時候則為0）。本報表控件支持直接寫串口和并口的功能，這便于以指令方式操作票據(jù)打印 機、錢箱和客顯等設(shè)備（ASP.NETt示例）。ComNan屬性：設(shè)置串口或并口名稱， COM至COM25為串口，LPT1至LPT2為 并口。BaudRate屬性：串口的波特率，默認為 9600。Stopbits 屬性：串口的停止位，默認為 ONESTOPBIT 0, ONE5STOPBITS1, TWOSTOPBITS =。2這個一般不用修改設(shè)置。Bytesize屬性：數(shù)據(jù)位的長度，默認為 &這個一般不用修改設(shè)置。TimeOut屬性：數(shù)據(jù)發(fā)送超時，串口則為寫一個數(shù)據(jù)位的超時，并口

14、的超時 為整個數(shù)據(jù)的傳送時間，默認為 3000毫秒。isCheckPrint屬性：串口打印時是否檢測打印機狀態(tài) (標(biāo)準(zhǔn)EPSO或仿EPSON 打印機有效)，默認為 0。WriteComData函數(shù)，功能為把數(shù)據(jù)寫入端口，參數(shù)：要寫入的數(shù)據(jù)。返回值 0表示成功， -1表示端口打開失敗， -2表示數(shù)據(jù)發(fā)送失敗， -3表示打印機故障。 此函數(shù)在寫數(shù)據(jù)時，會打開端口、寫入數(shù)據(jù)、然后關(guān)閉端口，所以在同一個函數(shù) 中只要調(diào)用一次，先把數(shù)據(jù)組織好，然后再調(diào)用此函數(shù)一次性寫入端口。本報表控件支持多種語言，對于非簡體中文的語言，在安裝包中提供PrintActivex(English).exe 文件，若要使用此安裝

15、包，可把此文件改名為PrintActivex.exe 替換示例中的 PrintActivex.exe 文件，然后客戶端再下載安 裝，也可以直接在客戶端雙擊此文件進行安裝。該文件包的語言為英文。本報表控件提供的函數(shù)不多， 但因為是采用報表文件和數(shù)據(jù)集分開， 可以通 過報表設(shè)計器設(shè)計功能豐富的報表。其設(shè)計效率和報表的美觀可以和C/S架構(gòu)的報表設(shè)計進行媲美。示例中的ASP所采用的數(shù)據(jù)庫為Access，直接把ASP這個文件夾拷貝到Web艮 務(wù)器所對應(yīng)的We文件夾下就可以運行。示例中的ASP.NET所采用的數(shù)據(jù)庫為SQL Server 2000，數(shù)據(jù)庫保存在 App_Data目錄，直接附加就可以，所采用的開發(fā)工具是 Visual Studio 2008,運 行之前要修改 Web.config 中 PrintTestConnectionString字符串。示例中的PHP所采用的數(shù)據(jù)庫為MySq