ApplyRepeatedPageFragment

Sideoppsett, tagget PDF, ytelse

Beskrivelse

Plasserer ett fanget Form XObject på hver valgt side mens hver plassering merkes som et artefakt utenfor det logiske strukturtreet

Den fangede strømmen og dens ressurser deles av alle plasseringer, noe som unngår gjentatt konstruksjon av identiske hoder, gruppeetiketter, bakgrunner, arknummer, vannmerker 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);

Parametere

CaptureID	Et gjenbrukbart fangstresultat returnert av EndFormXObject eller et annet fangst-API for Form i det gjeldende dokumentet
PageRange	Et sideområdeuttrykk, eller en tom streng for alle sider
Left, Top, Width, Height	Plasseringsrektangel sendt til DrawCapturedPage; koordinater må være endelige, og dimensjonene må være positive
ArtifactType	Én av `Pagination`, `Layout`, `Page` eller PDF 2.0 `Background`
ArtifactSubtype	Tom med mindre `ArtifactType` er `Pagination`; aksepterte standardverdier er `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` og `Bates`

Returverdier

Returnerer antall sider der fragmentet ble plassert, eller 0 når valideringen mislykkes, området er tomt eller gjeldende API-omfang ikke kan endre sider

Merknader

Funksjonen bevarer kallerens valgte side og tegnertilstand

Background, PageNum, LineNum, Redaction og Bates hever utdatafunksjonsversjonen til PDF 2.0

Gjentatte plasseringer er alltid artefakter; tegn en separat semantisk forekomst utenfor dette kallet når den første forekomsten hører hjemme i leserrekkefø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;