SetStructElemExpansionA

PDF etiquetado & accesibilidad

Descripción

La A final indica el punto de entrada ANSI (char) de la DLL; la interfaz 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 actual de SetAnsiMode

Establece la entrada /E (texto de expansión) en el elemento de estructura que se está creando en la pila de etiquetas; el texto de expansión es la forma desarrollada de una abreviatura o sigla contenida en el elemento, por ejemplo World Wide Web para un elemento Span cuyo contenido es WWW, o International Organization for Standardization para un Span que contiene ISO

Los lectores de pantalla y otras tecnologías de asistencia pronuncian el texto desarrollado en lugar de intentar pronunciar los caracteres abreviados, lo cual es esencial para las abreviaturas que no pueden pronunciarse como palabras

Sintaxis

Delphi

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

DLL

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

Parámetros

Expansion	El texto completamente expandido de la abreviatura o el acrónimo en el elemento de estructura actual. Pase una cadena vacía para borrar un valor establecido previamente

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

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 se distingue de las demás propiedades de texto:

/E (Expansión) 鈥?La forma desarrollada de una abreviatura o sigla Se usa para que los lectores de pantalla pronuncien contenido en línea abreviado
/Alt (vea SetStructElemAltText) — Una descripción sustitutiva completa para elementos que no pueden representarse visualmente (imágenes, figuras, fórmulas)
/ActualText (consulte SetStructElemActualText) — Un reemplazo Unicode exacto para secuencias de glifos cuyo texto extraído sería incorrecto de otro modo (ligaduras, variantes de glifos)

PDF/UA-1 (ISO 14289-1 §7.2) exige que pueda determinarse sin ambigüedad el idioma natural de cada fragmento de texto Para abreviaturas y acrónimos cuya forma abreviada no puede leerse en voz alta como palabra, /E es el mecanismo estándar para proporcionar esa información

Aplique /E al elemento más interno que envuelve la abreviatura, normalmente un elemento Span. La expansión se aplica solo al contenido de ese elemento y no la heredan 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