Getting Started

安裝、Delphi 與 FPC 設定,以及第一個程式

PDF Library for Delphi 是 Delphi 的 PDF 程式庫。把程式庫單元加進專案、需要建立或修改 PDF 文件時 new 一個 TPDFlib 實例,就能在程式碼中使用。

路徑設定

告訴 Delphi 到哪裡找 PDF Library for Delphi 的原始檔或編譯好的 DCU 檔。可以一次設定全域 Library Path,或為每個使用本程式庫的專案設定 Search Path

要設定全域 Library Path,請使用這個 Delphi 選單路徑:

Tools -> Options -> Language -> Delphi -> Library -> Library path

較舊的 Delphi 版本中,這個設定可能出現在:

Tools -> Environment Options -> Library -> Library path

加入已安裝的原始碼路徑或對應的編譯後二進位檔路徑。例如:

%UserProfile%\Documents\losLab\PDFlibPas\Lib
%UserProfile%\Documents\losLab\PDFlibPas\Lib\37.0\Win32\Release
%UserProfile%\Documents\losLab\PDFlibPas\Lib\37.0\Win64\Release

第一個路徑是預設的原始碼版本路徑。帶版本的路徑是 RAD Studio 13 Florence 編譯 DCU 的範例,請使用與你安裝的 Delphi 或 C++Builder 版本相符的 BDS 版本資料夾

只想設定目前專案的 Search Path,請使用:

Project -> Options -> Building -> Delphi Compiler -> Search path

較舊的 Delphi 版本中,這個設定可能出現在:

Project -> Options -> Directories/Conditionals -> Search path

類別與單元名稱

主程式庫單元在 i386-win32,二進位套件中為 x86_64-win64。主要類別是

build-Lazarus-Lib.cmd win32
build-Lazarus-Tests.cmd win32
build-Lazarus-Demo.cmd win32
build-Lazarus-Lib.cmd win64

debugnorunFPCfpc.exe

Lib\FPC\i386-win32Lib\FPC\x86_64-win64Lib\FPC\compatLib\thirdpartyLib\FPC\PDFlibPasLaz.lpk

Tests\Lazarus\bin\<target>bin\<target>Lib\thirdparty\Win32fPDFlibJBIG2EncC

build-Lazarus-Demo-TRIAL.cmd win32win64build-Lazarus-Lib-TRIAL.cmd win32win64

類別與單元名稱

PDFlibrary.pasPDFlibrary.dcuTPDFlib.

宣告類別

PDF Library for Delphi 是 Delphi 程式庫,不是 VCL 元件,不會安裝到 IDE 的元件面板。把 PDFlibrary 加進單元的 uses 子句、宣告一個 TPDFlib 型別的變數,然後呼叫 Create 建構子;用完呼叫 Free,通常放在 try..finally 區塊裡。

第一個 PDF Library 程式

建立新的 VCL Forms 應用程式,在表單上放一個 TButton。把 PDF Library for Delphi 單元加進表單單元:

uses
  Windows, Messages, SysUtils, Variants, Classes, Graphics,
  Controls, Forms, Dialogs, PDFlibrary;

在按鈕上按兩下,加入這個事件處理器:

procedure TForm1.Button1Click(Sender: TObject);
var
  PDFlib: TPDFlib;
begin
  PDFlib := TPDFlib.Create;
  try
    PDFlib.DrawText(100, 500, 'Hello from Delphi');
    PDFlib.SaveToFile('.\HelloFromDelphi.pdf');
  finally
    PDFlib.Free;
  end;
end;

完整工作流程

建立第一份 PDF 之後,可以探索隨附的 Demo/Delphi、Demo/C++Builder 或 Demo/Lazarus 範例集:Showcase 提供視覺化導覽,各領域實驗室則從單一執行檔提供專門情境

執行 DocumentLab --scenario DocumentInspectionWorkbench 可取得頁面清單與診斷報告,或用該情境文件記載的命令列引數提供自己的 PDF

執行 ContentLab --scenario WorkflowGallery 可看到完整的文件交付工作流程:表格、註解、交接檢查清單、HTTP 輸出與存檔驗證

DLL 使用者可以從 Demo/CSharp/DLL/WorkflowWorkbench 或 Demo/VB.NET/DLL/WorkflowWorkbench 開始,體驗報告產生、擷取、頁面組合與二進位記憶體傳輸;經驗證的連結與導覽請看 Demo/VC++/DLL/LinkDemo

開啟安裝套件中的 Demo/DLL.en-us.html,可取得 DLL 工作流程目錄與各架構的建置說明

更多資訊

詳細的 API 文件請使用這份 HTML 參考。可在導覽窗格依函式名稱、類別或主題關鍵字搜尋。

產品新訊與更多資訊,請造訪 PDF Library for Delphi 產品頁。