ApplyRepeatedPageFragment

Seitenlayout, Tagged PDF, Performance

Beschreibung

Platziert ein erfasstes Form-XObject auf jeder ausgewählten Seite und markiert jede Platzierung als Artefakt außerhalb des logischen Strukturbaums

Der erfasste Stream und seine Ressourcen werden von allen Platzierungen geteilt, was den wiederholten Aufbau identischer Kopfzeilen, Gruppenbeschriftungen, Hintergründe, Kolophontexte, Wasserzeichen oder Dekorfragmente vermeidet

Syntax

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

Parameter

CaptureID	Eine wiederverwendbare Erfassung, die von EndFormXObject oder einer anderen API zur Form-XObject-Erfassung im aktuellen Dokument zurückgegeben wurde
PageRange	Ein Seitenbereichsausdruck oder ein leerer String für alle Seiten
Left, Top, Width, Height	An DrawCapturedPage übergebenes Platzierungsrechteck; Koordinaten müssen endlich sein und die Abmessungen positiv
ArtifactType	Einer der Werte `Pagination`, `Layout`, `Page` oder PDF 2.0 `Background`
ArtifactSubtype	Leer, außer `ArtifactType` ist `Pagination`; akzeptierte Standardwerte sind `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` und `Bates`

Rückgabewerte

Gibt die Anzahl der Seiten zurück, auf denen das Fragment platziert wurde, oder 0, wenn die Validierung fehlschlägt, der Bereich leer ist oder der aktuelle API-Bereich keine Seiten ändern kann

Anmerkungen

Die Funktion erhält die vom Aufrufer ausgewählte Seite und den Malerzustand

Background, PageNum, LineNum, Redaction und Bates heben die Ausgabefunktionsversion auf PDF 2.0 an

Wiederholte Platzierungen sind immer Artefakte; zeichnen Sie eine separate semantische Vorkommen außerhalb dieses Aufrufs, wenn das erste Vorkommen in die Lesereihenfolge gehört

Beispiel

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;