BeginArtifactExA

PDF etiquetado, Accesibilidad

Descripción

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

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

Use esta función para expresar tipo de artefacto (Pagination, Layout o Page) y subtipo (Header, Footer, Watermark, PageNum o LineNum) juntos. Para uno solo basta BeginArtifact

Cada llamada a BeginArtifactEx debe ir seguida de la llamada correspondiente 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 del tipo de artefacto escrito como propiedad /Type. Valores válidos según ISO 32000-1 §14.8.2.2.1:
  • Pagination — encabezado, pie, número de página u otro elemento de paginación
  • Layout — contenido determinado por el diseño, como líneas de columnas 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 propiedades)
ArtifactSubtypeSubtipo de paginación escrito como propiedad /Subtype. Solo es significativo cuando ArtifactType es Pagination. Valores habituales: 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

0Error (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;