ApplyRepeatedPageFragment

ページレイアウト、タグ付きPDF、パフォーマンス

説明

1つのキャプチャ済みForm XObjectを選択中の全ページへ配置し、各配置を論理構造ツリーの外側のアーティファクトとしてマークします

キャプチャされたストリームとそのリソースは全配置で共有されるため、同一のヘッダー、グループラベル、背景、ページ番号、透かし、装飾フラグメントを繰り返し構築するのを避けられます

構文

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

パラメータ

CaptureID	EndFormXObjectまたは現在のドキュメント内の別のフォームキャプチャAPIが返した再利用可能なキャプチャ
PageRange	ページ範囲式、またはすべてのページを表す空の文字列
Left, Top, Width, Height	DrawCapturedPageへ渡される配置矩形。座標は有限値で、寸法は正でなければなりません
ArtifactType	`Pagination`、`Layout`、`Page`、またはPDF 2.0の`Background`のいずれか
ArtifactSubtype	`ArtifactType`が`Pagination`でない限り空。受け入れられる標準値は`Header`、`Footer`、`Watermark`、`PageNum`、`LineNum`、`Redaction`、`Bates`です

戻り値

フラグメントが配置されたページ数を返します。検証に失敗した場合、範囲が空の場合、または現在のAPIスコープがページを変更できない場合は0を返します

備考

この関数は呼び出し元の選択ページとペインター状態を保持します

Background、PageNum、LineNum、Redaction、Batesは出力機能バージョンをPDF 2.0へ引き上げます

繰り返し配置は常にアーティファクトです。最初の出現を読み順に含めるべき場合は、この呼び出しの外側で別途セマンティックな出現を描画してください

例

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;