TPDFlib

コアオブジェクト、ドキュメント作成、ドキュメント管理

説明

TPDFlib（ユニット Lib\PDFlibrary.pas）は PDF Library for Delphi の中心クラスです。1 つのインスタンスで複数の PDF 文書を同時に扱えます。NewDocument は空の文書を開始し、LoadFromFile は既存文書を読み込み、SelectDocument はアクティブ文書を切り替え、DocumentCount は開いている文書数を報告します。すべての描画、テキスト、フォーム、注釈、セキュリティ、署名、抽出、レンダリング、印刷、および検証の呼び出しは、現在選択されている文書を対象とします

PDFlibrary ユニットは包括ユニットです。uses 節に追加すると公開サーフェス全体が取り込まれるため、ほとんどのプログラムでは Uses PDFlibrary; だけが必要です

構文

Delphi

Uses PDFlibrary;

Var
  PDF: TPDFlib;
Begin
  PDF:= TPDFlib.Create;
  Try
    ...
  Finally
    PDF.Free;
  End;
End;

パラメータ

Create / Destroyインスタンスのライフサイクル。解放すると開いているすべてのドキュメントが閉じられます
NewDocument新しい空の PDF ドキュメントを開始して選択する
LoadFromFile既存の PDF をディスクから読み込み（必要に応じてパスワードを指定）、選択します
SelectDocument開いている別の文書をアクティブにします
DocumentCountインスタンスで現在開いているドキュメント数
SaveToFileアクティブな文書をディスクに書き込みます (増分更新では以前の署名がそのまま保持されます)
LastErrorCode最近のエラーの数値コード。最後の呼び出しが成功した場合は 0
Abort / Aborted長時間実行される処理を協調的にキャンセルし、キャンセル状態を報告します
OnProgress / OnOperationProgress長時間操作用の粗粒度および細粒度の進行状況コールバック
OnPassword暗号化されたドキュメントで必要な場合にホストへパスワードを要求する
Logger構造化ログレコードを受け取るオプションの TPDFlibLogger インスタンス
MailProviderメール関数が使用する省略可能な IPDFlibMailProvider

備考

このドキュメントのリファレンスページでは、文書管理、ページレイアウト、ベクターグラフィックス、フォントとテキスト（HTML story と text flow を含む）、画像、フォームと JavaScript、注釈とリンク、アウトラインと出力先、セキュリティとデジタル署名、タグ付き PDF、PDF/A と PDF/UA 準拠、コンテンツ抽出と Direct Access、レンダリング（SelectRenderer で GDI+、Cairo、PDFium を選択）、印刷、preflight レポート、および TPDFlibViewer を介したビューアー統合というタスク別に、メンバーを 1 つずつ説明します

ほとんどのメンバーには、TPDFlib の WideString メソッド、DL 接頭辞付きの DLL エントリポイント（狭い文字列を使う呼び出し元向けの A 接尾辞付き ANSI バリアントを含む。SetAnsiMode を参照）、および PDFlib library 自動化オブジェクト上の ActiveX/COM メソッドという 3 種類の並行形式があります。メンバーごとのページには Delphi と DLL の構文が並べて示されています

例

// Create a document, draw one line of text and save it
Uses PDFlibrary;

Procedure Demo;
Var
  PDF: TPDFlib;
Begin
  PDF:= TPDFlib.Create;
  Try
    PDF.NewDocument;
    PDF.AddStandardFont('Helvetica');
    PDF.PrintText(50, 750, 'Hello from PDF Library for Delphi');
    PDF.SaveToFile('hello.pdf');
  Finally
    PDF.Free;
  End;
End;

関連項目

DocumentationHome、GettingStarted、NewDocument、LoadFromFile、SelectDocument、DocumentCount、LastErrorCode、SelectRenderer、TPDFlibViewer、TPDFlibLogger