TPdf - PDFium Delphi Component

Модул: PDFium

Използвайте компонента TPdf за отваряне, навигация, извличане на текст и редактиране на PDF документи

Пример

Pdf.FileName := 'document.pdf';
Pdf.Password := 'password';
Pdf.Active := True; // open PDF document
Pdf.PageNumber := 1; // select page
ShowMessage(Pdf.Text); // extract text

Типове

type TBookmark = record
  Handle: FPDF_BOOKMARK;
  Title: WString;
  PageNumber: Integer;
  Destination: TDestination;
  DescendantCount: Integer;
  IsOpen: Boolean;
  Action: TPdfAction;
  ActionPageNumber: Integer;
  ActionDestination: TDestination;
  ActionPath: WString;
  HasColor: Boolean;
  Color: TColor;
end;

type TBookmarks = array of TBookmark;

Данни за отметка

type TDestination = record
  Handle: FPDF_DEST;
  Name: WString;
  PageNumber: Integer;
  ViewMode: TPdfDestinationViewMode;
  ViewParameterCount: Integer;
  ViewParameters: TPdfDestinationViewParameters;
  HasX: Boolean;
  X: Single;
  HasY: Boolean;
  Y: Single;
  HasZoom: Boolean;
  Zoom: Single;
end;

Данни за наименувано местоназначение

type TPdfDestinationViewMode = (dvmUnknown, dvmXYZ, dvmFit, dvmFitHorizontal, dvmFitVertical, dvmFitRectangle, dvmFitBoundingBox, dvmFitBoundingBoxHorizontal, dvmFitBoundingBoxVertical);

type TPdfDestinationViewParameters = array [0..3] of Single;

Режим на изглед на местоназначението и неговите подредени нативни параметри

type TLinkAnnotation = record
  Handle: FPDF_LINK;
  Rectangle: TPdfRectangle;
  PageNumber: Integer;
  Action: TPdfAction;
  ActionPageNumber: Integer;
  ActionPath: WString;
  Points: array of TQuadrilateralPoint;
end;

type TLinkAnnotations = array of TLinkAnnotation;

type TQuadrilateralPoint = array [1..4] of TPdfPoint;

Данни за анотация на връзка

type TPdfPermission = (permPrint, permModify, permCopy, permAnnotate, permFillForms, permAccessibility, permAssemble, permPrintHighQuality);

type TPdfPermissions = set of TPdfPermission;

Типизирани флагове за разрешения на документа, декодирани от нативната маска за разрешения

type TPdfDocumentMetadata = record
  Title: WString;
  Author: WString;
  Subject: WString;
  Keywords: WString;
  Creator: WString;
  Producer: WString;
  CreationDate: WString;
  ModifiedDate: WString;
end;

Една моментна снимка на стандартните полета на речника Info на документа

type TObjectType = (otUnknown, otText, otPath, otImage, otShading, otForm);

Определя типа на PDF обекта

type TPageMode = (pmNone, pmOutline, pmThumbs, pmFullScreen, pmOptionalContentGroup, pmAttachments, pmUnknown);

Определя как документът PDF трябва да бъде показан при отваряне

pmNone - не се виждат нито контурът на документа, нито миниатюрните изображения
pmOutline - контурът на документа е видим
pmThumbs - миниатюрните изображения са видими
pmFullScreen - режим на цял екран, без лента с менюта, контроли на прозореца или друг видим прозорец
pmOptionalContentGroup - видим е панелът на групата за незадължително съдържание
pmAttachments - видим е панелът за прикачени файлове
pmUnknown - неизвестен режим на страница

type TPdfAction = (acUnsupported, acGoto, acGotoRemote, acUri, acLaunch);

Определя типа на действие, свързано с елемент на отметка

acUnsupported - неподдържан тип действие
acGoto - преминава към местоназначение в текущия документ
acGotoRemote - преминава към местоназначение в друг документ
acUri - Universal Resource Identifier, включително уеб страници и други интернет ресурси
acLaunch - стартира приложение или отваря файл

type TPdfAnnotation = record
  Subtype: TPdfAnnotationSubtype;
  Flags: TPdfAnnotationFlags;
  HasColor: Boolean;
  Color: TColor;
  ColorAlpha: Byte;
  HasInteriorColor: Boolean;
  InteriorColor: TColor;
  InteriorColorAlpha: Byte;
  HasAttachmentPoints: Boolean;
  AttachmentPoints: TQuadrilateralPoint;
  Rectangle: TPdfRectangle;
  ContentsText: WString;
  AuthorText: WString;
end;

Данни за анотация

type TPdfAnnotationFlag = (afInvisible, afHidden, afPrint, afNoZoom, afNoRotate, afNoView, afReadOnly, afLocked, afToggleNoView);

type TPdfAnnotationFlags = set of TPdfAnnotationFlag;

Флагове за анотация

type TPdfAnnotationSubtype = (anUnknown, anText, anLink, anFreeText, anLine, anSquare, anCircle, anPolygon, anPolyLine, anHighlight, anUnderline, anSquiggly, anStrikeout, anStamp, anCaret, anInk, anPopup, anFileAttachment, anSound, anMovie, anWidget, anScreen, anPrinterMark, anTrapNet, anWaterMark, anThreed, anRichMedia, anXfaWidget, anRedact);

Подтипът на анотацията

type TPdfBlendMode = (bmDefault, bmColor, bmColorBurn, bmColorDodge, bmDarken, bmDifference, bmExclusion, bmHardLight, bmHue, bmLighten, bmLuminosity, bmMultiply, bmNormal, bmOverlay, bmSaturation, bmScreen, bmSoftLight);

Определя как слоевете се смесват един с друг

type TPdfDisplayMode = (dmSingleContinuous, dmTwoPageContinuous, dmTwoPageContinuousWithCover);

Определя как се показват страниците на PDF документа

dmSingleContinuous - Показва страниците непрекъснато в една колона
dmTwoPageContinuous - Показва страниците непрекъснато в две колони
dmTwoPageContinuousWithCover - Показва първата страница самостоятелно, а след това останалите страници непрекъснато в две колони

type TPdfFeature = (feUnknown, feXfaForm, fePortableCollection, feAttachment, feSecurity, feSharedReview, feSharedFormAcrobat, feSharedFormFilesystem, feSharedFormEmail, fe3dAnnotation, feMovieAnnotation, feSoundAnnotation, feScreenMediaAnnotation, feScreenRichMediaAnnotation, feAttachmentAnnotation, feSignatureAnnotation);

Функция на PDF документа, докладвана от събитието OnUnsupportedFeature

type TPdfFillMode = (fmNone, fmAlternate, fmWinding);

Определя как се образуват запълнените области, когато пътят се пресича сам

fmNone - без запълване
fmAlternate - правило за четно-нечетен паритет
fmWinding - правило за ненулево навиване

type TPdfFormFieldFlag = (ffReadOnly, ffRequired, ffNoExport, ffMultiline, ffChoiceCombo, ffChoiceEdit, ffPassword, ffChoiceMultiSelect);

type TPdfFormFieldFlags = set of TPdfFormFieldFlag;

Флагове на полето на формуляр

type TPdfFormFieldInfo = record
  Name: WString;
  AlternateName: WString;
  FieldType: TPdfFormFieldType;
  Flags: TPdfFormFieldFlags;
  OptionLabels: array of WString;
  OptionSelected: array of Boolean;
  FontSize: Single;
  Checked: Boolean;
  ExportValue: WString;
  GroupCount: Integer;
  GroupIndex: Integer;
end;

Информация за полето на формуляр

type TPdfFormFieldType = (fiUnknown, fiPushButton, fiCheckBox, fiRadioButton, fiComboBox, fiListBox, fiTextField, fiSignature);

Определя типа на полето на формуляр

type TPdfFormType = (ftUnknown, ftNone, ftAcroForm, ftXfaFull, ftXfaForeground);

Определя типа на формулярите в PDF документа

ftUnknown - неизвестен тип формуляр
ftNone - няма формуляри в документа
ftAcroForm - формулярите са зададени чрез спецификацията AcroForm
ftXfaFull - формулярите са зададени чрез цялата XFA спецификация
ftXfaForeground - формулярите са зададени чрез подмножеството XFAF на XFA спецификацията

type TPdfImage = record
  Width: Integer;
  Height: Integer;
  Data: TBytes;
end;

Размер в пиксели и данни на PDF обекта изображение

type TPdfLineCap = (lcDefault, lcButt, lcRound, lcProjectingSquare);

Формата, която се използва в краищата на отворените подпътища

type TPdfLineJoin = (ljDefault, ljMiter, ljRound, ljBevel);

Формата, която се използва в ъглите на контурите, които се очертават

type TPdfPoint = record
X, Y: Double;
end;

Точка с координати X и Y

type TPdfRectangle = record
Left, Top, Right, Bottom: Double;
end;
type TPdfRectangles = array of TPdfRectangle;

Правоъгълна област с координати Left, Top, Right и Bottom

type TPdfFileIdentifierType = (fidPermanent, fidChanging);

Селектор на файловия идентификатор на trailer. fidPermanent чете първия /ID запис, а fidChanging чете втория /ID запис

type TPdfPageBox = (pbMedia, pbCrop, pbBleed, pbTrim, pbArt);

Селектор на поле на речника на страницата, използван от PageBox, GetPageBox и SetPageBox

type TPdfJavaScriptAction = record
Name: WString;
Script: WString;
end;
type TPdfJavaScriptActions = array of TPdfJavaScriptAction;

Данни за действие от дървото на имената на JavaScript на ниво документ

type TPdfSignature = record
  Content: TBytes;
  Encoding: WString;
  Reason: WString;
  Time: WString;
  Permission: Integer;
end;

Информация за цифров подпис

type TPdfIntegerArray = array of Integer;

Целочислен масив, използван от списъците с идентификатори за маркирано съдържание на дървото на структурата

type TPdfSingleArray = array of Single;

Масив с плаваща запетая с единична точност, използван от сетърите за позиция на знаците на текстовия обект

type TPdfPrintPageRange = record
StartPage: Integer;
EndPage: Integer;
end;
type TPdfPrintPageRanges = array of TPdfPrintPageRange;

Диапазони на страници за печат (номерата са от 1) от предпочитанията на преглеждащия за документа

type TPdfStructureElement = record
  Level: Integer;
  ParentIndex: Integer;
  TypeName: WString;
  ObjectType: WString;
  Title: WString;
  AlternateText: WString;
  ActualText: WString;
  Expansion: WString;
  ID: WString;
  Language: WString;
  MarkedContentID: Integer;
  MarkedContentIDs: TPdfIntegerArray;
  ChildCount: Integer;
  ChildMarkedContentIDs: TPdfIntegerArray;
  AttributeCount: Integer;
  ListNumbering: WString;
  Scope: WString;
  HasHeaders: Boolean;
  HeadersIds: array of WString;
  ColSpan: Integer;
  RowSpan: Integer;
  HasPrintField: Boolean;
  NamespaceUri: WString;
  RoleMappedNamespaceUri: WString;
  RoleMappedTypeName: WString;
  HasReference: Boolean;
  HasAssociatedFile: Boolean;
  AssociatedFileRelationship: WString;
  AssociatedFileDescription: WString;
  AnnotationSubtype: WString;
  AnnotationContents: WString;
  AnnotationAlternateText: WString;
  IsArtifact: Boolean;
  WidgetCount: Integer;
  HasAppearance: Boolean;
  LabelText: WString;
  FieldAlternateName: WString;
end;

type TPdfStructureElements = array of TPdfStructureElement;

Сплеснати данни за логически структурни елементи за маркирани PDF страници

type TPdfFormSelectionRect = record
PageNumber: Integer;
Bounds: TPdfRectangle;
end;

Един правоъгълник в пространството на страницата, притежаван от извикващия, докладван от нативния избор на текст във формуляр

type TPdfStructureReadOptions = record
  MaxDepth: Integer;
  MaxElements: Integer;
  MaxAttributeValues: Integer;
  DeadlineMilliseconds: Cardinal;
  IncludeAttributes: Boolean;
  class function Default: TPdfStructureReadOptions; static;
end;

Ресурсни бюджети за итеративно нативно обхождане на дървото на структурата

type TPdfStructureReadStatus = record
  Completed: Boolean;
  ElementsVisited: Integer;
  AttributeValuesVisited: Integer;
  DepthLimitReached: Boolean;
  ElementLimitReached: Boolean;
  AttributeLimitReached: Boolean;
  DeadlineReached: Boolean;
  VisitorStopped: Boolean;
end;

Подробности за завършване и съкращаване, върнати от методите за обхождане на структурата

type TPdfVersion = (pvUnknown, pv10, pv11, pv12, pv13, pv14, pv15, pv16, pv17);

Версията на PDF файл или изрична цел на SaveAs. Възможните стойности са: неизвестна версия, PDF версия 1.0 до 1.7. Изричните цели на SaveAs от PDF 1.3 до PDF 1.7 се нормализират и валидират спрямо избраната PDF версия

type TPrintPaperHandling = (phUndefined, phSimplex, phDuplexFlipShortEdge, phDuplexFlipLongEdge);

Опции за обработка на хартията при печат

phUndefined - неопределена обработка на хартията
phSimplex - едностранен печат
phDuplexFlipShortEdge - двустранен печат, обръщане по късия ръб
phDuplexFlipLongEdge - двустранен печат, обръщане по дългия ръб

type TPdfPrintMode = (prEmf, prTextOnly, prPostScript2, prPostScript3, prPostScript2PassThrough, prPostScript3PassThrough, prEmfImageMasks, prPostScript3Type42, prPostScript3Type42PassThrough);

Режим на изход за печат на Windows PDFium, избран от SetPdfPrintMode

prEmf - EMF изход
prTextOnly - само текстов изход
prPostScript2 - изход PostScript ниво 2
prPostScript3 - изход PostScript ниво 3
prPostScript2PassThrough - изход PostScript ниво 2 pass-through
prPostScript3PassThrough - изход PostScript ниво 3 pass-through
prEmfImageMasks - EMF изход с маски на изображения
prPostScript3Type42 - изход PostScript ниво 3 Type 42
prPostScript3Type42PassThrough - изход PostScript ниво 3 Type 42 pass-through

type TRenderOption = (reAnnotations, reLcd, reNoNativeText, reGrayscale, reDebugInfo, reNoCatchException, reLimitCache, reHalftone, rePrinting, reReverseByteOrder, reNoSmoothText, reNoSmoothImage, reNoSmoothPath, reInvert, reNightDuotone);

type TRenderOptions = set of TRenderOption;

Флагове за изобразяване на страница

reAnnotations - изобразява анотации
reLcd - изобразяване на текст, оптимизирано за LCD дисплей
reNoNativeText - да не се използва нативният текстов изход, наличен на някои платформи
reGrayscale - изход в сива скала
reDebugInfo - задайте, ако искате да получите информация за отстраняване на грешки
reNoCatchException - задайте, ако не искате да улавяте изключения
reLimitCache - ограничава размера на кеша на изображенията
reHalftone - винаги използва полутонове за разтягане на изображенията
rePrinting - изобразява за печат
reReverseByteOrder - изобразява в обратен ред на байтовете; този флаг е активен само при изобразяване в растерно изображение
reNoSmoothText - изключва антиалиасинга на текста
reNoSmoothImage - изключва антиалиасинга на изображенията
reNoSmoothPath - изключва антиалиасинга на пътищата
reInvert - инвертира изобразените RGB канали като пост-изобразяваща трансформация за слабо зрение на TPdfView
reNightDuotone - свързва изобразената осветеност с TPdfView.NightDuotoneInk и TPdfView.NightDuotonePaper

type TRotation = (ro0, ro90, ro180, ro270);

Завъртането на PDF страницата. Завъртането на страницата е по посока на часовниковата стрелка

ro0 - без завъртане на страницата
ro90 - завъртане на страницата на 90 градуса по часовниковата стрелка
ro180 - завъртане на страницата на 180 градуса по часовниковата стрелка
ro270 - завъртане на страницата на 270 градуса по часовниковата стрелка

type TSaveOption = (saNone, saIncremental, saNoIncremental, saRemoveSecurity);

Определя как ще бъде записан PDF документът

saNone - запис по подразбиране
saIncremental - инкрементално записване
saNoIncremental - без инкрементално записване
saRemoveSecurity - премахва защитата

type TSearchOption = (seCaseSensitive, seWholeWord, seConsecutive);

type TSearchOptions = set of TSearchOption;

Флагове за търсене

seCaseSensitive - съвпадение по малки и главни букви
seWholeWord - съвпадение на цялата дума
seConsecutive - да не се прескача текущото съвпадение при търсене на следващото

type TWebLink = record
Url: WString;
Rectangles: TPdfRectangles;
end;

type TWebLinks = array of TWebLink;

URL информация и граници за уеб връзката

type WString = {$ifdef D2009PLUS} string {$else} WideString {$endif D2009PLUS};

Широк низ

Константи

const PointsPerInch: Integer = 72;

PDF използва точки с плътност от 72 точки на инч

const FLAT_NORMALDISPLAY = 0;
const FLAT_PRINT = 1;

Профили на сплескване, подадени на FlattenPage / FlattenAllPages. FLAT_NORMALDISPLAY е насочен към показване на екран; FLAT_PRINT е насочен към отпечатан изход

const FLATTEN_FAIL = 0;
const FLATTEN_SUCCESS = 1;
const FLATTEN_NOTHINGTODO = 2;

Кодове за резултат, върнати от FlattenPage

type TPdfReadingUnit = record
  Text: WString;
  Kind: TPdfContentFragmentKind;
  HeadingLevel: Integer;
  Page: Integer;
  Rects: TPdfRectangles;
  FragmentIndex: Integer;
  SentenceIndex: Integer;
  IsAlternateText: Boolean;
  Language: WString;
end

type TPdfReadingUnits = array of TPdfReadingUnit;

Единици за четене на ниво изречение, използвани от работни потоци за превръщане на текст в реч и помощно четене със слушане

type TPdfWordBox = record
  Text: WString;
  StartIndex: Integer;
  Count: Integer;
  Rect: TPdfRectangle;
  Page: Integer;
end

type TPdfWordBoxes = array of TPdfWordBox;

Текстови диапазони на ниво дума и правоъгълници на страница, използвани от синхронизираните подчертавания при четене

type TPdfSpokenSpan = record
  SpokenStart: Integer;
  SpokenCount: Integer;
  Page: Integer;
  StartIndex: Integer;
  Count: Integer;
end

type TPdfSpokenSpans = array of TPdfSpokenSpan;

Свързани участъци, които преобразуват отместванията на речевия двигател обратно към текста на PDF страницата

type TPdfSpokenText = record
Text: WString;
Spans: TPdfSpokenSpans;
end

type TPdfSpokenTexts = array of TPdfSpokenText;

Речеви части и съответствия на източника, използвани от работни потоци за четене на глас и TPdfReadingSession

type TPdfReadingSessionState = (pssIdle, pssSpeaking, pssPaused);

Състояние на възпроизвеждане, докладвано от TPdfReadingSession

Глобални променливи

var LibraryName: string = 'pdfium.dll';

Име на стандартната PDFium библиотека, използвана, когато EnableV8Engine е False. Може да бъде променено преди извикването на LoadLibrary

var EnableV8Engine: Boolean = False;

Задайте True преди зареждане, за да изберете pdfium.v8.dll от съответстващата папка Win32 или Win64 DLLs

TPdf компонент

Модул: PDFium

Пример

Типове

Константи

Глобални променливи

Глобални функции

Свойства

Методи

Събития