ApplyRepeatedPageFragment

Sidlayout, taggad PDF, prestanda

Beskrivning

Placerar ett inspärrat Form XObject på varje vald sida samtidigt som varje placering markeras som en artefakt utanför det logiska strukturträdet

Det inspärrade strömobjektet och dess resurser delas av alla placeringar, vilket undviker upprepade konstruktioner av identiska sidhuvuden, grupperubriker, bakgrunder, sidnummer, vattenstämplar eller dekorativa fragment

Syntax

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

Parametrar

CaptureID	En återanvändbar inspärning som returnerats av EndFormXObject eller ett annat Form-inspärnings-API i det aktuella dokumentet
PageRange	Ett sidintervallsuttryck, eller en tom sträng för alla sidor
Left, Top, Width, Height	Placeringsrektangel som skickas till DrawCapturedPage; koordinaterna måste vara ändliga och dimensionerna positiva
ArtifactType	En av `Pagination`, `Layout`, `Page` eller PDF 2.0 `Background`
ArtifactSubtype	Tomt såvida inte `ArtifactType` är `Pagination`; accepterade standardvärden är `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` och `Bates`

Returvärden

Returnerar antalet sidor på vilka fragmentet placerades, eller 0 när valideringen misslyckas, intervallet är tomt eller det aktuella API-scope inte kan ändra sidor

Anmärkningar

Funktionen bevarar anroparens valda sida och ritartillstånd

Background, PageNum, LineNum, Redaction och Bates höjer utdatafunktionens version till PDF 2.0

Upprepade placeringar är alltid artefakter; rita en separat semantisk förekomst utanför detta anrop när den första förekomsten hör till läsordningen

Exempel

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;