文電通 PDF Reader OCX 使用手冊

產品簡介

DocuCom PDF Reader OCX是專為Windows平台下的開發人員設計的一個ActiveX組件，可以讓開發者僅僅只用幾行代碼就可以輕 鬆實現對PDF讀取、列印、旋轉、縮放、平滑等等操作，而且每一個操作可定制性極強。全面支持PDF 1.3和PDF 1.4格式標准，經過不斷努力，現在對於不同國家和地區的字體都已經全面支持。還可以被集成到所有涉及文檔管理的軟件應用中，如OA、工作流管理等等。

以下分類內容可幫助更詳細了解有關PDF Reader OCX此文檔的全部信息：

 系統配置要求

--- Pentium系列中央處理器 --- MicrosoftWindows™ 98 Second Edition, Windows NT4 with SP 6, Windows 2000 Professional, Windows XP Professional/Home, or Windows XP Tablet PC --- 64 MB 內存 (推荐使用128 MB) --- 5 MB 硬盤空間供安裝文件使用 安裝程序在安裝過程中要自動生成臨時文件夾，所以實際要求的硬盤空間比上述空間要大些，另外，通常閱讀PDF文件的時候，您需要更多的空間來保存這些臨時文件。

 PDF Reader OCX產品版本分類:

DocuCom PDF Reader OCX共分3個版本：

試用版本:
試用版本的 DocuCom Reader OCX 可以免費從以下網址下載並安裝以進行評估：http://www.pdfwizard.com/。

  • 網上還可以找到棣南公司的“樣例”可執行程序，用來了解更多Reader OCX的特性與功能。

  • 提示安裝試用版本後，可以在 “開始 > 程序 > Zeon DocuCom > Reader OCX〝裡面找到“Sample Container〝。
SDK 版本:
可以從我們的網站http://www.pdfwizard.com/ 購買SDK版本 與相關文檔和源代碼，僅限用於開發目的使用:
  • “PDF Reader OCX SDK” 文檔（PDF格式）包含詳細的API函數描述。
  • VC和VB樣例的完整源代碼。 SDK 客戶被授權可按其需求控制或修改代碼。
  • 提示 1: 在線付費購買SDK版本後，您將收到Reader OCX 的“Product Serial Number”。請按照說明激活SDK版本。
  • 提示 2: 在安裝SDK版本後，可以在“開始 > 程序 > Zeon DocuCom > Reader OCX〝 裡找到“Sample Container” 、源代碼和文檔。
OEM 版本:
用於開發用戶端應用程序。
  • 簽署 OEM 合作合同後，一份為每位客戶量身訂做的OEM安裝程序和目標應用程序將按時發送。
  • 在初始化過程中，“一對一〝的 “Key Code” (序號) 將發送給客戶用以初始化Reader OCX 。
  • 提示 1: OEM 版本安裝後不會在電腦中出現安裝界面。

 如何購買 PDF Reader OCX

  • 下載試用版評估
    請訪問我們的網站並下載、安裝試用版本的 PDF Reader OCX和sample container。試用版本的PDF Reader OCX 會在每一頁PDF文件上自動添加浮水印。
  • 棣南線上商店購買
    SDK 版本 (供開發商使用) SDK 版本本身包含OCX、API 文件，和VC 、VB的樣例源代碼。請到 http://www.pdfwizard.com 訪問線 上商店，按提示完成在線信用卡支付。也可下載並填寫訂單，傳真給我們。
  • OEM 捆綁銷售
     有關OEM合約事宜請與 sales@pdfwizard.com聯繫。通常需要貴公司的介紹和軟件產品介紹。 OEM 客戶將收到 OEM 版本的 Reader OCX 。

 如何安裝/卸載 PDF Reader OCX

重要提示： 由於 Reader OCX 可能與Windows中的其他程序共享一個模塊，為避免衝突，Reader OCX 安裝程序將被放置在 “Program Files\Zeon\DocuCom\PDF Reader OCX”。
提示 試用版本生成的PDF頁面有浮水印。
SDK 版本 您可以直接從我們的網上商店購買，立即下載和安裝。按照屏幕指示完成安裝。 收到“Product Serial Number”，用它來把試用版本轉變為正式版本，去除水印。 如需去掉SDK版本中“Sample Container”的試用水印，您可參考“如何初始化Reader OCX”部分自己修改源代碼。 如需在自己的代碼中去掉試用水印，請參考“如何初始化Reader OCX”部分來正確初始化ReaderOCX。只要ReaderOCX被正確初始化，水印將不再存在。

安裝文件夾
上面已經提到的原因，PDF ReaderOCX被安裝到固定目錄 “Program Files\Zeon\DocuCom\PDF ReaderOCX\”下， 並自動創建一個“Sample Container”快捷方式。在SDK版本中，還創建了與開發文檔和範例代碼相關的快捷方式。 提示在試用版本和SDK版本中，你不能修改ReaderOCX.OCX的安裝路徑，否則會造成一些版本相關的錯誤。
　

試用版本和 SDK 版本

  • 按以下步驟執行 " PDFReaderOCX_SDK_Setup.exe" 程序： 開始 > 程序 > 設置 > 控制面板 > 添加/刪除程序
  • 在安裝對話框裡，總是點擊“下一步”。按屏幕提示操作，並“接受”合約書條約。
  • 敲入姓名、組織名稱 (可不填)，選擇用戶，然後點擊“下一步”或“安裝”。
  • 當安裝完成以後，會有提示。點擊“完成”結束安裝。
  • 提示文件安裝在 “Program Files\Zeon\DocuCom\PDF ReaderOCX\”，Sample Container生成快捷鍵。SDK 版本更生成相關文件和源代碼的快捷鍵。
  • 提示 您不能改變PDF Reader OCX 文件的目標文件夾，因為OCX模塊須經註冊而且與其他程序共用。

OEM 版本特定安包
默認安裝OEM版本的安裝程序是 PDFReaderOCXSetup_20000123.exe（此處20000123是您購買時的Order Number）。它是一個靜態模式的安裝包，即在安裝過程中不會出現任何用戶界面，所有的Reader OCX 都安裝到固定地點: “$PROGRAMFILES”\ZEON\DocuCom\PDF ReaderOCX.

指定安裝目錄: 一般情況下，不能修改默認的安裝目錄，原因見本節開頭。當然，有時有的應用程序可能需要選擇自己的安裝文件夾。開發商可以在 準備好碰到問題的情況下，在執行Reader OCX安裝程序前，將Windows註冊表裡添加以下內容: [HKEY_LOCAL_MACHINE\SOFTWARE\ZEON\DocuCom\PDF ReaderOCX] "Install_Dir"="C:\\Program Files\\ZEON\\DocuCom\\PDF ReaderOCX" 可以為您的安裝目錄修改路徑。

安裝程序會在安裝目錄中生成一個叫做PDFReaderOCXUnInstall.exe的文件。可以在Windows註冊表裡找到： [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\ Uninstall\PDFReaderOCXSetup] "DisplayName"="DocuCom PDFReaderOCX (remove only)" "UninstallString"= "\"C:\\Program Files\\ZEON\\DocuCom\\PDF ReaderOCX\\PDFReaderOCXUnInstall.exe\""

在這種情況下，可以執行下面的命令來卸載 Reader OCX: "C:\Program Files\ZEON\DocuCom\PDF ReaderOCX\PDFReaderOCXUnInstall.exe"

 如何初始化 PDF Reader OCX

Reader OCX 必須正確初始化，否則，每頁文件上會有水印出現。

  • 試用版本
    總是有水印。
  • SDK 版本
    客戶購買SDK版本后會收到“Product Serial Number〝。用“SN〝激活Reader OCX 可以去除水印
  • OEM Edition
    簽署合同后，客戶將收到OEM 安裝程序和 “Key Code” (序號) 用以激活OEM版本。“Key Code” (序號) 是一個32字節的數據，例如： E9A2-643D-4DB7-76EF-A392-239F-291D-E894

必須用棣南公司發送的“Key Code”激活Reader:
------------------- VC 樣例: -------------------
CPDFReaderOCX* pPDFReaderOCX = new CPDFReaderOCX() ; pPDFReaderOCX->Create( ... ) ; pPDFReaderOCX->Initialize("E9A2643D4DB776EFA392239F291DE894" ) ; pPDFReaderOCX->OpenFile( szFileName, szPassword ) ;
------------------- VB樣例: ------------------
Dim lr As Long PDFReaderOCX1.Initialize ("E9A2643D4DB776EFA392239F291DE894")lr = PDFReaderOCX1.OpenFile(ParamText1.Text, ParamText2.Text) ReturnValue.Text = CStr(lr)

 附加範例

棣南公司的“Sample Container”用來展示可被客戶應用程序識別的 功能和特性。
重要提示 “Sample Container”僅僅作為一個范例程序，絕不是一個完整無錯或仔細校對過的軟件，其中不包含詳盡的錯誤處理和限制，同時如果您不修改源代碼，就會顯示試用水印。
如何去除試用版本的水印: 對于帶源代碼和sample container的SDK版本，用戶必須按照"如何初始化Reader OCX"來操作。然后重新編譯sample container來去除水印。

  • 試用版本
    試用版本僅僅包含了可執行程序，此程序會生成相關快捷方式。
  • SDK 版本
    SDK 版本包含VC和VB的樣例源代碼和API函數。您可以隨心所欲的修改或者加入自己的程序。 如果您想使用有水印的Sample container，請修改源代碼以初始化Reader OCX 每詳細信息請參考“如何初始化Reader OCX〝。
  • OEM 版本
    OEM 版本僅用于銷售目的客戶。不包含 “Sample Container”。 啟動 Sample Container: 點“開始”菜單，選擇: “程序 > Zeon DocuCom > PDF Reader OCX > Sample Container”

如何獲得支援與協助


常見問題 ：http://www.pdfwizard.com/chs/faq/faq.aspx
技術支援: 線上技術支援
推廣/銷售： sales@pdfwizard.com
一般情況下，客戶提出的技術問題可在24小時內得到回答。SDK版本的客戶更可享受優先服務。
更新/升級
在主版本號相同的情況下，稱“更新”產品。例如，購買5.0版本的客戶可以免費更新到5打頭的任何版本。 “更新”則意味著對產品Bug的修正、小的產品改進以及維護性修改等。
總的來說，對OEM授權方式，不論更新或昇級均需要付費，例如從4.x 到 5.x。 “升級”是產品方面大的變動，通常伴隨API函數更改。
OEM 客戶無須再為終端用戶購買升級版本。通常只需要付少量固定費用就可以換新的OEM安裝程序。
文檔
PDF Reader OCX SDK: 這個文檔詳細描述了每一個API函數。必須付費購買Reader OCX SDK版本。
範例程序源代碼: VC、VB、DELPHI完整的範例程序源代碼可提供給開發商。您必須購買Reader OCX SDK版本才能獲得。

已知問題

  • VB 列印問題 由于Visual Basic 自身的一些原因，你不能在VB中使用默認的“Printer.hdc”來進行PDF 文檔的打印。你必須使用“CreateDC”函數來完成打印功能。我們正在進一步與微軟取得聯繫。
  • 漸變（Shade）問題目前不是所有的漸變類型都支持。不過我們計划在2003年12月份內推出新版本，到時將對漸變提供全面的支持。

版權所有 ◎2005 棣南公司

此出版品上任何內容，包括其中描述的產品內容，都不允許在不經文字許可的情況下，通過電郵、拍照，或任何方式復制、保存、轉發。此網站所有的軟件只有嚴格遵守和符合《 使用者條約》的用戶方可使用。 此出版品的解釋權歸棣南公司所有，內容可不經通告隨時修改。棣南公司對本出版品不做任何保証，同時特別聲明不對本文件是否適用于某一特殊目的，或是否侵犯第三方權利做出保証。

棣南股份有限公司
*******************************************************************
臺北市德行西路37號3F(11158)
Tel: +886-2-2833-9800 Fax: +886-2-2833-9840
Web: www.zeon.com.tw or www.pdfwizard.com
Email: sales@pdfwizard.com
******************************************************************