BeginMarkedContent
PDF etiquetado, accesibilidad
Descripción
Abre un rango de contenido marcado en el flujo de contenido actual escribiendo un operador BDC (Begin Marked Content with Property List). Esto se usa normalmente para crear PDF estructurados (etiquetados) que satisfacen los requisitos de accesibilidad (como PDF/UA)
Los rangos de contenido marcado deben estar correctamente equilibrados: cada llamada a BeginMarkedContent debe cerrarse con una llamada correspondiente a EndMarkedContent. Los rangos de contenido marcado pueden anidarse
Sintaxis
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;Parámetros
| TagType | El nombre de la etiqueta estructural, p. ej. /Span, /P, /Figure, etc. |
|---|---|
| AltText | Texto de descripción alternativo para accesibilidad (se corresponde con la clave /Alt de la lista de propiedades). Pase una cadena vacía si no es necesario. |
| ActualText | Texto real que sustituye a la representación de glifos para los lectores de pantalla (se corresponde con la clave /ActualText). Pase una cadena vacía si no es necesario. |
| Lang | El código de lenguaje natural del contenido marcado (p. ej. en-US; se corresponde con la clave /Lang). Pase una cadena vacía si no es necesario. |
| Expansion | El texto de expansión para abreviaturas o siglas (se corresponde con la clave /E). Pase una cadena vacía si no es necesario. |
Valores devueltos
| 0 | No hay ningún documento abierto o no se pudo escribir el contenido marcado. |
|---|---|
| 1 | Rango de contenido marcado abierto correctamente. |
Observaciones
Para generar archivos PDF/UA etiquetados conformes, asegúrese de que las etiquetas de estructura lógica rodean todo el texto y los gráficos visibles. Esta función ofrece una asignación de propiedades más precisa en comparación con BeginTag
Ejemplo
// Heading, then a paragraph with marked content span
PDF.NewDocument;
PDF.AddPage;
PDF.BeginMarkedContent('/Span', 'Logo description', '', 'en-US', '');
// Draw graphics or print text here
PDF.EndMarkedContent;