ApplyRepeatedPageFragment

Pagina-indeling, getagde PDF, prestaties

Beschrijving

Plaatst één vastgelegd Form XObject op elke geselecteerde pagina terwijl elke plaatsing als artifact buiten de logische structuurboom wordt gemarkeerd

De vastgelegde stream en zijn resources worden gedeeld door alle plaatsingen, zodat identieke koppen, groepslabels, achtergronden, folio's, watermerken of decoratieve fragmenten niet herhaaldelijk worden opgebouwd

Syntaxis

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

Parameters

CaptureID	Een herbruikbare vastlegging die door EndFormXObject of een andere Form-vastleggings-API in het huidige document wordt teruggegeven
PageRange	Een paginabereikexpressie, of een lege string voor elke pagina
Left, Top, Width, Height	Plaatsingsrechthoek die aan DrawCapturedPage wordt doorgegeven; coördinaten moeten eindig zijn en afmetingen positief
ArtifactType	Eén van `Pagination`, `Layout`, `Page` of PDF 2.0 `Background`
ArtifactSubtype	Leeg tenzij `ArtifactType` `Pagination` is; geaccepteerde standaardwaarden zijn `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` en `Bates`

Retourwaarden

Geeft het aantal pagina's terug waarop het fragment is geplaatst, of 0 wanneer validatie mislukt, het bereik leeg is of de huidige API-scope pagina's niet kan wijzigen

Opmerkingen

De functie behoudt de geselecteerde pagina en de painter-status van de aanroeper

Background, PageNum, LineNum, Redaction en Bates verhogen de uitvoerfunctieversie naar PDF 2.0

Herhaalde plaatsingen zijn altijd artifacts; teken een aparte semantische occurratie buiten deze aanroep wanneer de eerste occurratie in de leesvolgorde thuishoort

Voorbeeld

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;