SetStructElemActualText

PDF etiquetado & accesibilidad

Descripción

Establece la entrada /ActualText en el elemento de estructura que se está creando en la pila de etiquetas; ActualText proporciona el texto Unicode exacto que representa el elemento y reemplaza cualquier texto extraído del flujo de contenido PDF por el software lector

Use esta función cuando los glifos representados en la secuencia de contenido no se asignen directamente a los caracteres previstos en el orden de lectura, por ejemplo, un glifo de ligadura (ﬀ, ﬁ, ﬂ) que debería leerse como la secuencia de dos caracteres ff, fi o fl Sin ActualText, las herramientas de extracción de texto y los lectores de pantalla pueden generar resultados incorrectos para dichos glifos

Sintaxis

Delphi

Function TPDFlib.SetStructElemActualText(Const ActualText: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemActualText(ActualText As String) As Long

DLL

int DLSetStructElemActualText(int InstanceID, const wchar_t * ActualText);

Parámetros

ActualText	La cadena de texto Unicode que se asociará con el elemento de estructura actual. Pase una cadena vacía para borrar un valor establecido anteriormente

Valor devuelto

Devuelve 1 si tiene éxito, 0 si no hay ningún elemento de estructura abierto actualmente o no hay ningún documento seleccionado

Observaciones

Llame a esta función inmediatamente después de BeginTag o BeginTagEx mientras el elemento de destino esté en la parte superior de la pila de etiquetas

ActualText y AltText tienen propósitos distintos. AltText (establecido mediante el parámetro AltText de BeginTag) es una representación alternativa de todo el elemento destinada a tecnología de asistencia cuando el contenido visual no se puede representar. ActualText complementa la extracción de texto del flujo de contenido: reemplaza la secuencia de caracteres extraída del elemento, pero no suprime la representación. Los lectores de pantalla que admiten ambos suelen usar ActualText para la salida leída en voz alta cuando está presente

ISO 32000-1 §14.9.4 define ActualText como una entrada de cadena de texto PDF en el diccionario de elementos de estructura PDF/UA-1 (ISO 14289-1 §7.1) exige que el contenido de texto pueda extraerse y sea correcto; ActualText es el mecanismo estándar para satisfacer este requisito en secuencias de glifos cuya extracción directa sería ambigua o incorrecta

Ejemplo

// Tag a ligature glyph so that text extraction yields "fi"
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemActualText('fi');
PDFlib.TextOut(x, y, #$FB01);   // U+FB01 LATIN SMALL LIGATURE FI
PDFlib.EndTag;

Véase también

BeginTag, BeginTagEx, SetStructElemID, AddTagAttribute, GetPDFUADiagnostics