ApplyRepeatedPageFragment

Rozvržení stránek, tagované PDF, výkon

Popis

Umístí jeden vyňatý Form XObject na každou vybranou stránku, zatímco každé umístění označí jako artefakt mimo logický strom struktury

Vyňatý proud a jeho prostředky sdílí všechna umístění, čímž se vyhne opakované stavbě identických záhlaví, štítků skupin, pozadí, číslování listů, vodoznaků nebo dekorativních fragmentů

Syntaxe

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

Parametry

CaptureID	Opakovaně použitelné zachycení vrácené funkcí EndFormXObject nebo jiným zachytávacím API formulářů v aktuálním dokumentu
PageRange	Výraz rozsahu stránek, nebo prázdný řetězec pro všechny stránky
Left, Top, Width, Height	Umístovací obdélník předávaný funkci DrawCapturedPage; souřadnice musí být konečné a rozměry kladné
ArtifactType	Jedna z hodnot `Pagination`, `Layout`, `Page` nebo PDF 2.0 `Background`
ArtifactSubtype	Prázdné, pokud `ArtifactType` není `Pagination`; přijímané standardní hodnoty jsou `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` a `Bates`

Návratové hodnoty

Vrací počet stránek, na nichž byl fragment umístěn, jinak 0, selže-li validace, je-li rozsah prázdný nebo nemůže-li aktuální rozsah API měnit stránky

Poznámky

Funkce zachovává vybranou stránku a stav kresliče volajícího

Background, PageNum, LineNum, Redaction a Bates zvyšují verzi výstupních funkcí na PDF 2.0

Opakovaná umístění jsou vždy artefakty; samostatný sémantický výskyt nakreslete mimo toto volání, když první výskyt patří do pořadí čtení

Příklad

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;