SetStructElemTitleA

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

Establece /T del elemento actual. El título es una etiqueta legible específica, por ejemplo Capítulo 1, Tabla resumen o Figura 3: Ventas trimestrales, no solo el tipo

Sintaxis

Delphi

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

DLL

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

Parámetros

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

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

Title cumple una función distinta de las demás propiedades de texto de un elemento de estructura:

/T (Title) — Etiqueta descriptiva del elemento utilizada en paneles de navegación y etiquetado. Adecuada para encabezados de sección, rótulos de tabla y pies de figura
/Alt (véase SetStructElemAltText) — Sustituto textual completo para tecnología asistencial cuando no puede renderizarse el elemento
/ActualText (consulte SetStructElemActualText) — Sustitución Unicode exacta para secuencias de glifos cuyo texto extraído sería incorrecto

Los visores PDF utilizan /T para etiquetar elementos en el panel de navegación Tags. Las herramientas de accesibilidad y el software de corrección lo utilizan como título de punto de referencia para navegar. En los encabezados (H1–H6), el propio contenido sirve como texto; /T resulta más útil para elementos sin texto (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