EndArtifact
PDF etiquetado, Accesibilidad
Descripción
Cierra el artefacto más reciente escribiendo EMC en el flujo actual. Cada BeginArtifact debe corresponder a un EndArtifact
Sintaxis
Delphi
Function TPDFlib.EndArtifact: Integer;ActiveX
Function PDFlib::EndArtifact() As LongDLL
int DLEndArtifact(int InstanceID);Valores devueltos
| 0 | Fallo: no hay ningún documento abierto o ninguna región de artefacto abierta actualmente |
|---|---|
| 1 | La región de artefacto se cerró correctamente |
Observaciones
Las regiones de artefacto y los elementos de estructura comparten la misma pila de contenido marcado para la página actual. EndArtifact solo cierra la región abierta situada en la parte superior si se abrió con BeginArtifact; nunca lo utilice para cerrar un elemento de estructura abierto con BeginTag o sus variantes — llame a EndTag para esos elementos
Las regiones de artefacto pueden anidarse dentro de elementos de estructura cuando el artefacto representa un gráfico decorativo que pertenece visualmente al contenido estructural. Sin embargo, no pueden contener elementos de estructura: los lectores PDF advertirán sobre la estructura dentro de un artefacto o se negarán a respetarla
Los subtipos de artefacto habituales que justifican una región independiente son los encabezados, pies y números de página, los bordes decorativos, las marcas de agua y las imágenes de fondo. Marcarlos como artefactos los mantiene fuera del orden de lectura que la tecnología de asistencia presenta al usuario
Ejemplo
// Running footer drawn once per page, as an artifact
PDF.BeginArtifact('Footer');
PDF.SetFontSize(8);
PDF.PrintText(50, 30, 'Annual Report 2026 — page ' + IntToStr(pageNo));
PDF.EndArtifact;
// Page header with the company logo, also an artifact
PDF.BeginArtifact('Header');
PDF.DrawImage(50, 800, 60, 30, logoHandle);
PDF.EndArtifact;