SetStructElemExpansionA

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

Establece /E en el elemento actual: expansión completa, por ejemplo World Wide Web para un Span con WWW, o International Organization for Standardization para un Span con ISO

Los lectores de pantalla y otras tecnologías de asistencia pronuncian el texto expandido en vez de intentar pronunciar los caracteres abreviados, algo esencial para las abreviaturas que no se pueden pronunciar como palabras

Sintaxis

Delphi

Function DLSetStructElemExpansionA(InstanceID: Integer; Expansion: PAnsiChar): Integer;

DLL

int DLSetStructElemExpansionA(int InstanceID, const char * Expansion);

Parámetros

Expansion	Texto completamente expandido de la abreviatura o el acrónimo del 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 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

La entrada /E se define en ISO 32000-1 §14.9.5. Se escribe como una cadena de texto PDF en el diccionario del elemento de estructura y es distinta de las demás propiedades de texto:

/E (Expansion) — Forma desarrollada de una abreviatura o sigla. Se utiliza para que los lectores de pantalla pronuncien contenido abreviado en línea
/Alt (consulte SetStructElemAltText) — Una descripción sustitutiva completa para los elementos que no se pueden representar visualmente (imágenes, figuras, fórmulas)
/ActualText (consulte SetStructElemActualText) — Una sustitución Unicode exacta para secuencias de glifos cuyo texto extraído sería incorrecto en otro caso (ligaduras, variantes de glifos)

PDF/UA-1 (ISO 14289-1 §7.2) exige determinar el idioma de todo texto. Para abreviaturas no pronunciables como palabra, /E proporciona la expansión

Aplique /E al elemento más interno que envuelve la abreviatura, normalmente un elemento Span. La expansión solo se aplica al contenido de ese elemento y no se hereda en los hijos

Ejemplo

// Tag an abbreviation with its expansion
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('World Wide Web');
PDFlib.WriteText('WWW');
PDFlib.EndTag;

// Tag a standards acronym
PDFlib.BeginTag('Span', '', '');
PDFlib.SetStructElemExpansion('International Organization for Standardization');
PDFlib.WriteText('ISO');
PDFlib.EndTag;

Véase también

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemLang, GetPDFUADiagnostics