ApplyRepeatedPageFragment

Layout di pagina, PDF con tag, prestazioni

Descrizione

Colloca un Form XObject acquisito su ogni pagina selezionata marcando ogni collocazione come artefatto fuori dall'albero di struttura logica

Il flusso acquisito e le sue risorse sono condivisi da tutte le collocazioni, evitando la costruzione ripetuta di intestazioni, etichette di gruppo, sfondi, foli, filigrane o frammenti decorativi identici

Sintassi

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

Parametri

CaptureID	Un'acquisizione riutilizzabile restituita da EndFormXObject o da un'altra API di acquisizione Form nel documento corrente
PageRange	Un'espressione di intervallo di pagine, oppure una stringa vuota per tutte le pagine
Left, Top, Width, Height	Rettangolo di posizionamento passato a DrawCapturedPage; le coordinate devono essere finite e le dimensioni positive
ArtifactType	Uno tra `Pagination`, `Layout`, `Page` o `Background` di PDF 2.0
ArtifactSubtype	Vuoto a meno che `ArtifactType` sia `Pagination`; i valori standard accettati sono `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` e `Bates`

Valori restituiti

Restituisce il numero di pagine su cui il frammento è stato posizionato, oppure 0 quando la validazione fallisce, l'intervallo è vuoto o l'ambito API corrente non può modificare le pagine

Note

La funzione preserva la pagina selezionata e lo stato del painter del chiamante

Background, PageNum, LineNum, Redaction e Bates elevano la versione della funzionalità di output a PDF 2.0

Le collocazioni ripetute sono sempre artefatti; disegnate un'occorrenza semantica separata fuori da questa chiamata quando la prima occorrenza appartiene all'ordine di lettura

Esempio

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;