THotPDF.BeginDoc

THotPDF

Creates new document.

Delphi 語法：

procedure BeginDoc ( Initial: boolean = false );

C++ 語法：

void __fastcall BeginDoc ( bool Initial = false );

說明

BeginDoc 會啟動新的 PDF 文件並建立第一頁。一般使用時，請以預設參數值呼叫 BeginDoc，然後在 CurrentPage 上繪製

一個 THotPDF 執行個體可以接連寫出任意多份文件。EndDoc 寫出檔案後，會丟棄為該文件註冊的一切：影像、字型、表單欄位、大綱、文件 JavaScript、具名目的地、頁面標籤、ICC 設定檔、輸出意圖與其他資源。已寫文件的頁面與物件仍留在記憶體中，因此 EndDoc 之後 ValidatePDFUA2Structure 這類檢查仍然可用，直到下一個 BeginDoc 將其釋放。下一份文件因此從乾淨狀態開始，前一個檔案的內容不會帶進來

FileName、Version、Compression、PDFACompliance、Author 與 Title 這類屬性會為下一份文件保留其值，頁面圖層、字型後備鏈與可變字型軸選擇也一樣。在 EndDoc 之後、下一個 BeginDoc 之前註冊的任何東西，例如用 AddPDFAOutputIntent 加入的輸出意圖，或透過 Names 加入的指令碼，都屬於下一份文件。CurrentPageNumber、PagesCount 與已寫文件的版面診斷，同樣可一路讀取到下一個 BeginDoc

EndDoc 會清除 UserPassword 與 OwnerPassword。當 ActivateProtection 仍為開啟時，請在下一個 BeginDoc 之前重新設定密碼；否則 BeginDoc 會擲出例外，而不是寫出一份用空密碼保護的文件。當某份文件的功能自動提高了 PDF 版本（例如為輸出意圖提高到 PDF 1.4）時，EndDoc 會把它調回 Version 屬性的值

HPDF := THotPDF.Create( nil );
try
  HPDF.FileName := '.\Output.pdf';
  HPDF.BeginDoc;   // Start PDF document creation
  HPDF.CurrentPage.TextOut( 100, 100, 0, 'Hello World!' );
  HPDF.EndDoc;     // Finish and save PDF document

  HPDF.FileName := '.\Second.pdf';
  HPDF.BeginDoc;   // Same instance, new independent document
  HPDF.CurrentPage.TextOut( 100, 100, 0, 'Second document' );
  HPDF.EndDoc;
finally
  HPDF.Free;
end;

請參閱： EndDoc