ApplyRepeatedPageFragment

Mise en page, PDF balisé, performances

Description

Place un Form XObject capturé sur chaque page sélectionnée en marquant chaque placement comme artefact en dehors de l'arbre de structure logique

Le flux capturé et ses ressources sont partagés par tous les placements, évitant la construction répétée d'en-têtes, d'étiquettes de groupe, d'arrière-plans, de folios, de filigranes ou de fragments décoratifs identiques

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

Paramètres

CaptureID	Une capture réutilisable renvoyée par EndFormXObject ou une autre API de capture de Form dans le document courant
PageRange	Une expression de plage de pages, ou une chaîne vide pour toutes les pages
Left, Top, Width, Height	Rectangle de placement transmis à DrawCapturedPage ; les coordonnées doivent être finies et les dimensions positives
ArtifactType	Une des valeurs `Pagination`, `Layout`, `Page`, ou `Background` (PDF 2.0)
ArtifactSubtype	Vide sauf si `ArtifactType` vaut `Pagination` ; les valeurs standard acceptées sont `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` et `Bates`

Valeurs de retour

Renvoie le nombre de pages sur lesquelles le fragment a été placé, ou 0 lorsque la validation échoue, que la plage est vide ou que la portée actuelle de l'API ne permet pas de modifier les pages

Remarques

La fonction préserve la page sélectionnée par l'appelant ainsi que son état de dessin

Background, PageNum, LineNum, Redaction et Bates élèvent la version de la fonctionnalité de sortie à PDF 2.0

Les placements répétés sont toujours des artefacts ; dessinez une occurrence sémantique séparée en dehors de cet appel quand la première occurrence appartient à l'ordre de lecture

Exemple

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;