SetStructElemAltTextA

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 SetStructElemAltText y los argumentos de cadena se interpretan utilizando la página de códigos SetAnsiMode actual

Establece la entrada /Alt en el elemento de estructura que se está creando en la pila de etiquetas. El texto alternativo es la descripción textual que las tecnologías de asistencia (lectores de pantalla y pantallas braille) presentan al usuario cuando el elemento no se puede representar visualmente — por ejemplo, una imagen, figura o fórmula matemática

Esta función equivale a pasar un argumento AltText no vacío a BeginTag o BeginTagEx, pero permite establecer o actualizar el texto alternativo después de abrir el elemento. Resulta útil cuando la descripción se calcula o recupera de forma asíncrona después de conocer el tipo de elemento

Sintaxis

Delphi

Function DLSetStructElemAltTextA(InstanceID: Integer; AltText: PAnsiChar): Integer;

DLL

int DLSetStructElemAltTextA(int InstanceID, const char * AltText);

Parámetros

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 inmediatamente después de BeginTag, mientras el elemento de destino esté en la parte superior de la pila de etiquetas, o en cualquier momento antes de la llamada correspondiente a EndTag

AltText sustituye textualmente todo el elemento para quien no ve la salida. ActualText (ISO 32000-1 §14.9.4) da la secuencia Unicode exacta de glifos en línea, como ligaduras, sin sustituir la renderización

ISO 32000-1 §14.9.3 define /Alt y PDF/UA-1 §7.5 lo exige en Figure y Formula. GetPDFUADiagnostics informa FIGURE-NO-ALT:N si falta

Ejemplo

// Tag an embedded chart image with alternative text
PDFlib.BeginTag('Figure', '', '');
PDFlib.SetStructElemAltText('Bar chart: Q1 sales 120, Q2 sales 145, Q3 sales 98');
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

Véase también

BeginTag, BeginTagEx, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics