ApplyRepeatedPageFragment

Układ strony, PDF z tagami, wydajność

Opis

Umieszcza jeden przechwycony Form XObject na każdej wybranej stronie, oznaczając każde umieszczenie jako artifact poza drzewem struktury logicznej

Przechwycony strumień i jego zasoby są współdzielone przez wszystkie umieszczenia, co pozwala uniknąć wielokrotnego budowania identycznych nagłówków, etykiet grup, teł, numeracji stron, znaków wodnych czy fragmentów ozdobnych

Składnia

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	Przechwyt wielokrotnego użytku zwrócony przez EndFormXObject lub inne API przechwytywania formularzy w bieżącym dokumencie
PageRange	Wyrażenie zakresu stron albo pusty łańcuch dla wszystkich stron
Left, Top, Width, Height	Prostokąt rozmieszczenia przekazywany do DrawCapturedPage; współrzędne muszą być skończone, a wymiary dodatnie
ArtifactType	Jedna z wartości `Pagination`, `Layout`, `Page` albo PDF 2.0 `Background`
ArtifactSubtype	Puste, chyba że `ArtifactType` ma wartość `Pagination`; dopuszczalne wartości standardowe to `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` i `Bates`

Wartości zwracane

Zwraca liczbę stron, na których umieszczono fragment, albo 0, gdy walidacja zawiedzie, zakres jest pusty albo bieżący zakres API nie może zmieniać stron

Uwagi

Funkcja zachowuje wybraną przez wywołującego stronę i stan malarza

Background, PageNum, LineNum, Redaction i Bates podnoszą wersję funkcji wyjściowych do PDF 2.0

Powtórzone umieszczenia są zawsze artifactami; gdy pierwsze wystąpienie należy do kolejności czytania, osobne semantyczne wystąpienie narysuj poza tym wywołaniem

Przykład

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;