TPDFlib

Đối tượng lõi, tạo tài liệu, quản lý tài liệu

Mô tả

TPDFlib (unit Lib\PDFlibrary.pas) là lớp trung tâm của PDF Library for Delphi. Một instance duy nhất chứa một hoặc nhiều tài liệu PDF cùng lúc: NewDocument khởi tạo một tài liệu rỗng, LoadFromFile nạp một tài liệu có sẵn, SelectDocument chuyển tài liệu hoạt động còn DocumentCount báo có bao nhiêu tài liệu đang mở. Mọi lời gọi vẽ, chữ, form, chú thích, bảo mật, chữ ký, trích xuất, render, in và validation đều thao tác trên tài liệu đang chọn

Unit PDFlibrary là unit ô trọn: thêm nó vào mệnh đề uses sẽ kéo theo toàn bộ mặt công khai, nên đa số chương trình chỉ cần Uses PDFlibrary;

Cú pháp

Delphi

Uses PDFlibrary;

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

Tham số

`Create` / `Destroy`	Vòng đời của instance; giải phóng nó sẽ đóng mọi tài liệu đang mở
`NewDocument`	Tạo tài liệu PDF mới rỗng và chọn nó
`LoadFromFile`	Nạp PDF có sẵn từ đĩa (có thể kèm mật khẩu) và chọn nó
`SelectDocument`	Đưa một tài liệu đang mở khác thành tài liệu hoạt động
`DocumentCount`	Số tài liệu hiện đang mở trong instance
`SaveToFile`	Ghi tài liệu đang hoạt động ra đĩa (incremental update giữ nguyên các chữ ký trước đó)
`LastErrorCode`	Mã số của lỗi gần nhất; 0 nếu lần gọi cuối thành công
`Abort` / `Aborted`	Hủy một thao tác chạy dài theo kiểu hợp tác và báo lại trạng thái hủy
`OnProgress` / `OnOperationProgress`	Các callback tiến trình thô và mịn cho các thao tác dài
`OnPassword`	Hỏi host xin mật khẩu khi một tài liệu bị mã hóa cần nó
`Logger`	Optional `TPDFlibLogger` instance receiving structured log records
`MailProvider`	`IPDFlibMailProvider` tùy chọn mà các hàm mail dùng

Ghi chú

Các trang tham khảo trong tài liệu này mô tả từng thành viên một, nhóm theo nhiệm vụ: quản lý tài liệu, bố cục trang, đồ họa vector, font và chữ (gồm cả HTML story và text flow), ảnh, form và JavaScript, chú thích và link, đề mục và điểm đến, bảo mật và chữ ký số, tagged PDF, tuân thủ PDF/A và PDF/UA, trích xuất nội dung và direct access, render (SelectRenderer chọn GDI+, Cairo hay PDFium), in, báo cáo preflight và tích hợp viewer qua TPDFlibViewer

Đa số thành viên tồn tại ở ba dạng song song: phương thức TPDFlib nhận WideString, entry point DLL với prefix DL (cộng các biến thể ANSI hậu tố A cho caller chuỗi hẹp, xem SetAnsiMode), và phương thức ActiveX/COM trên automation object PDFlib library. Các trang theo thành viên hiển thị cú pháp Delphi và DLL cạnh nhau

Ví dụ

// 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;

Xem thêm

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