ApplyRepeatedPageFragment

Diseño de página, PDF etiquetado, rendimiento

Descripción

Coloca un Form XObject capturado en cada página seleccionada marcando cada colocación como artefacto fuera del árbol de estructura lógica

El flujo capturado y sus recursos se comparten entre todas las colocaciones, evitando la construcción repetida de encabezados, etiquetas de grupo, fondos, folios, marcas de agua o fragmentos decorativos idénticos

Sintaxis

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	Una captura reutilizable devuelta por EndFormXObject u otra API de captura de Form en el documento actual
PageRange	Una expresión de rango de páginas, o una cadena vacía para todas las páginas
Left, Top, Width, Height	Rectángulo de colocación que se pasa a DrawCapturedPage; las coordenadas deben ser finitas y las dimensiones positivas
ArtifactType	Uno de `Pagination`, `Layout`, `Page` o el `Background` de PDF 2.0
ArtifactSubtype	Vacío salvo que `ArtifactType` sea `Pagination`; los valores estándar aceptados son `Header`, `Footer`, `Watermark`, `PageNum`, `LineNum`, `Redaction` y `Bates`

Valores devueltos

Devuelve el número de páginas en las que se colocó el fragmento, o 0 cuando la validación falla, el rango está vacío o el alcance actual de la API no puede modificar páginas

Observaciones

La función conserva la página seleccionada y el estado del pintor de quien la llama

Background, PageNum, LineNum, Redaction y Bates elevan la versión de la característica de salida a PDF 2.0

Las colocaciones repetidas son siempre artefactos; dibuje una ocurrencia semántica separada fuera de esta llamada cuando la primera ocurrencia pertenezca al orden de lectura

Ejemplo

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;