SetStructElemActualTextA

PDF etiquetado & accesibilidad

Descripción

El sufijo A indica el punto de entrada ANSI (char) de la DLL; la superficie ActiveX/COM expone únicamente la forma Unicode. El comportamiento es idéntico a SetStructElemActualText y los argumentos de cadena se interpretan utilizando la página de códigos SetAnsiMode actual

Establece /ActualText en el elemento actual de la pila. Proporciona el texto Unicode exacto, sustituyendo el extraído del flujo por el lector

Use esta función si los glifos no representan directamente los caracteres de lectura, como ligaduras (ﬀ, ﬁ, ﬂ) que deben leerse ff, fi o fl. Sin ActualText, extracción y lectores pueden fallar

Sintaxis

Delphi

Function DLSetStructElemActualTextA(InstanceID: Integer; ActualText: PAnsiChar): Integer;

DLL

int DLSetStructElemActualTextA(int InstanceID, const char * ActualText);

Parámetros

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

Valor devuelto

Devuelve 1 si la operación se realiza correctamente, o 0 si no hay ningún elemento de estructura abierto o ningún documento seleccionado

Observaciones

Llame a esta función justo después de BeginTag o BeginTagEx, con el elemento destino en la parte superior de la pila

ActualText y AltText tienen fines distintos. AltText (establecido mediante el parámetro AltText de BeginTag) es una representación alternativa de todo el elemento destinada a tecnologías de asistencia cuando el contenido visual no puede renderizarse. ActualText complementa la extracción de texto del flujo de contenido: sustituye la secuencia de caracteres extraída del elemento, pero no impide el renderizado. Los lectores de pantalla compatibles con ambos suelen utilizar ActualText para la salida leída en voz alta cuando está presente

ISO 32000-1 §14.9.4 define ActualText como cadena PDF del elemento. PDF/UA-1 §7.1 exige texto extraíble correcto y ActualText resuelve secuencias ambiguas o incorrectas

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