ApplyRepeatedPageFragment

Esquema de página, PDF etiquetado, desempenho

Descrição

Coloca um Form XObject capturado em todas as páginas selecionadas, marcando cada colocação como artefacto fora da árvore de estrutura lógica

O fluxo capturado e os respetivos recursos são partilhados por todas as colocações, evitando a construção repetida de cabeçalhos, rótulos de grupo, fundos, numeração de páginas, marcas de água ou fragmentos decorativos idênticos

Sintaxe

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

Parâmetros

CaptureID	Uma captura reutilizável devolvida por EndFormXObject ou outra API de captura de Form no documento atual
PageRange	Uma expressão de intervalo de páginas, ou uma cadeia vazia para todas as páginas
Left, Top, Width, Height	Retângulo de colocação passado a DrawCapturedPage; as coordenadas têm de ser finitas e as dimensões positivas
ArtifactType	Um de `Pagination`, `Layout`, `Page` ou PDF 2.0 `Background`
ArtifactSubtype	Vazio, a menos que `ArtifactType` seja `Pagination`; os valores padrão aceites são `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` e `Bates`

Valores devolvidos

Devolve o número de páginas em que o fragmento foi colocado, ou 0 quando a validação falha, o intervalo está vazio ou o âmbito atual da API não pode alterar páginas

Observações

A função preserva a página selecionada e o estado do pintor do chamador

Background, PageNum, LineNum, Redaction e Bates elevam a versão de funcionalidades de saída para PDF 2.0

As colocações repetidas são sempre artefactos; desenhe uma ocorrência semântica separada fora desta chamada quando a primeira ocorrência pertence à ordem de leitura

Exemplo

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;