BeginArtifactExA

PDF etiquetado, Accesibilidad

Descripción

La A final indica el punto de entrada ANSI (char) de la DLL; la interfaz ActiveX/COM expone solo la forma Unicode. El comportamiento es idéntico al de BeginArtifactEx y los argumentos de cadena se interpretan mediante la página de códigos actual de SetAnsiMode

Abre una secuencia de contenido marcado de artefacto de PDF con tipo de artefacto explícito y subtipo Pagination opcional en una sola llamada. Amplía BeginArtifact para admitir el diccionario completo de propiedades de artefacto definido en ISO 32000-1 §14.8.2.2.1 Table 330

Use esta función cuando necesite expresar tanto un tipo de artefacto (Pagination, Layout o Page) como un subtipo de Pagination (Header, Footer, Watermark, PageNum o LineNum) en un solo operador Para los casos en que solo se necesita una dimensión, BeginArtifact es suficiente

Cada llamada a BeginArtifactEx debe ir seguida de una llamada coincidente a EndArtifact

Sintaxis

Delphi

Function DLBeginArtifactExA(InstanceID: Integer; ArtifactType, ArtifactSubtype: PAnsiChar): Integer;

DLL

int DLBeginArtifactExA(int InstanceID, const char * ArtifactType, const char * ArtifactSubtype);

Parámetros

ArtifactTypeNombre de tipo de artefacto escrito como la propiedad /Type Los valores válidos según ISO 32000-1 §14.8.2.2.1 son:
  • Pagination — encabezado, pie de página, número de página u otro elemento de paginación
  • Layout — contenido guiado por el diseño, como reglas de columna o decoración de fondo
  • Page — contenido intrínseco de la página no vinculado a ninguna estructura lógica
Pase una cadena vacía para omitir /Type (el operador recurre solo a /Subtype o a /Artifact BMC sin más)
ArtifactSubtypeSubtipo de paginación escrito como propiedad /Subtype Solo tiene significado cuando ArtifactType es Pagination Valores comunes: Header, Footer, Watermark, PageNum, LineNum Pase una cadena vacía para omitir /Subtype

Operador escrito

Both non-empty/Artifact << /Type /T /Subtype /S >> BMC
Type only/Artifact << /Type /T >> BMC
Subtype only/Artifact << /Subtype /S >> BMC
Both empty/Artifact BMC

Valores devueltos

0Falló (no hay ningún documento abierto)
1La secuencia de artefacto se abrió correctamente

Ejemplo

// Mark a running header as a Pagination artifact with subtype Header
PDF.BeginArtifactEx('Pagination', 'Header');
PDF.PrintText(50, 780, 'Chapter 3  —  Results');
PDF.EndArtifact;

// Mark a column rule as a Layout artifact (no subtype needed)
PDF.BeginArtifactEx('Layout', '');
PDF.DrawLine(300, 50, 300, 750);
PDF.EndArtifact;