SetStructElemTitleA

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

Establece la entrada /T (título) en el elemento estructural que se está creando actualmente en la pila de etiquetas. El título es una etiqueta legible que caracteriza el elemento específico —por ejemplo Chapter 1, Summary Table o Figure 3: Quarterly Sales—, en lugar de repetir simplemente el tipo de elemento

Sintaxis

Delphi

Function DLSetStructElemTitleA(InstanceID: Integer; Title: PAnsiChar): Integer;

DLL

int DLSetStructElemTitleA(int InstanceID, const char * Title);

Parámetros

Title	Una cadena de texto legible que identifica esta instancia concreta de elemento. 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

La entrada /T se define en ISO 32000-1 §14.7.2 Tabla 324. Se escribe como una cadena de texto PDF en el diccionario de elementos de estructura

Title tiene una finalidad distinta de las demás propiedades de texto de un elemento de estructura:

/T (Title) — Una etiqueta descriptiva para el elemento usada en paneles de navegación y etiquetado. Adecuada para encabezados de sección, títulos de tablas y títulos de figuras
/Alt (consulte SetStructElemAltText) — Un sustituto textual completo del elemento para tecnología de asistencia cuando el elemento no puede renderizarse
/ActualText (consulte SetStructElemActualText) — Un reemplazo Unicode exacto para secuencias de glifos cuyo texto extraído sería incorrecto

Los visores de PDF usan /T para etiquetar elementos en el panel de navegación Tags. Las herramientas de accesibilidad y el software de corrección lo usan como título de referencia para la navegación. Para encabezados (H1–H6), el contenido funciona como texto de encabezado; /T es más útil para elementos no textuales (Table, Figure, Form) o contenedores (Sect, Div) que necesitan una etiqueta descriptiva

Ejemplo

// Tag a data table with a title for navigation and accessibility tools
PDFlib.BeginTag('Table', '', '');
PDFlib.SetStructElemTitle('Table 2: Annual Revenue by Region');
// ... table rows and cells
PDFlib.EndTag;

// Tag a document section
PDFlib.BeginTag('Sect', '', '');
PDFlib.SetStructElemTitle('Chapter 3: Implementation');
// ... section content
PDFlib.EndTag;

Véase también

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics