Getting Started

Установка, настройка Delphi и FPC, первая программа

PDF Library for Delphi — библиотека PDF для Delphi. Используется из кода: добавьте модуль библиотеки в проект и создайте экземпляр TPDFlib, когда нужно собрать или изменить PDF-документ

Настройка путей

Укажите Delphi, где искать исходники PDF Library for Delphi или скомпилированные DCU: можно один раз задать глобальный Library Path либо настроить Search Path для каждого проекта, использующего библиотеку

Чтобы задать глобальный Library Path, пройдите по этому меню Delphi:

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

For older Delphi releases this setting may appear under:

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

Первый путь — путь исходников издания по умолчанию; версии путей — примеры для скомпилированных DCU RAD Studio 13 Florence. Берите папку BDS-версии, соответствующую вашей установленной Delphi или C++Builder

Чтобы задать Search Path только текущего проекта, используйте:

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

For older Delphi releases this setting may appear under:

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

Класс и имя модуля

The main library unit is i386-win32, or x86_64-win64 in a binary package. The main class is

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

Free Pascal и Lazarus в Windows

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-сценариев и инструкции по сборке для каждой разрядности

Дополнительная информация

Этот HTML-справочник содержит подробную документацию по API; в панели навигации можно искать по имени функции, категории или ключевому слову темы

Новости продукта и дополнительная информация — на странице продукта PDF Library for Delphi