ApplyRepeatedPageFragment

Sidelayout, mærket PDF, ydeevne

Beskrivelse

Placerer ét fanget Form XObject på hver valgt side, mens hver placering markeres som et artifact uden for det logiske struktutræ

Den fangede strøm og dens ressourcer deles af alle placeringer, hvilket undgår gentagne opbygninger af identiske sidehoveder, gruppeetiketter, baggrunde, sideløbende numre, vandmærker eller dekorative fragmenter

Syntaks

Delphi

Function TPDFlib.ApplyRepeatedPageFragment(CaptureID: Integer;
  Const PageRange: WideString; Left, Top, Width, Height: Double;
  Const ArtifactType, ArtifactSubtype: WideString): Integer;

ActiveX

Function PDFlib::ApplyRepeatedPageFragment(CaptureID As Long,
  PageRange As String, Left As Double, Top As Double, Width As Double,
  Height As Double, ArtifactType As String,
  ArtifactSubtype As String) As Long

DLL

int DLApplyRepeatedPageFragment(int InstanceID, int CaptureID,
  const wchar_t* PageRange, double Left, double Top, double Width,
  double Height, const wchar_t* ArtifactType,
  const wchar_t* ArtifactSubtype);
int DLApplyRepeatedPageFragmentA(int InstanceID, int CaptureID,
  const char* PageRange, double Left, double Top, double Width,
  double Height, const char* ArtifactType,
  const char* ArtifactSubtype);

Parametre

CaptureID	En genbrugelig fangst returneret af EndFormXObject eller en anden Form-fangst-API i det aktuelle dokument
PageRange	Et sideintervaludtryk eller en tom streng for alle sider
Left, Top, Width, Height	Placeringsrektangel sendt til DrawCapturedPage; koordinaterne skal være endelige, og dimensionerne skal være positive
ArtifactType	En af `Pagination`, `Layout`, `Page` eller PDF 2.0 `Background`
ArtifactSubtype	Tom, medmindre `ArtifactType` er `Pagination`; accepterede standardværdier er `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` og `Bates`

Returværdier

Returnerer antallet af sider, hvorpå fragmentet blev placeret, eller 0, når valideringen fejler, intervallet er tomt, eller det aktuelle API-scope ikke kan ændre sider

Bemærkninger

Funktionen bevarer kalderens valgte side og tegnertilstand

Background, PageNum, LineNum, Redaction og Bates hæver output-funktionsversionen til PDF 2.0

Gentagne placeringer er altid artifacts; tegn en separat semantisk forekomst uden for dette kald, når den første forekomst hører hjemme i læserækkefølgen

Eksempel

PDF.BeginFormXObject(0, 0, 180, 24);
PDF.PrintText(0, 8, 'Confidential draft');
FragmentID:= PDF.EndFormXObject;

if PDF.ApplyRepeatedPageFragment(FragmentID, '2-end', 36, 806,
  180, 24, 'Pagination', 'Header')= 0 then
  HandleLayoutError;