RegisterFigure

PDF etiquetado

Descripción

Proporciona la descripción que llevará la siguiente imagen dibujada

Sintaxis

Delphi

Function TPDFlib.RegisterFigure(Const Description: WideString): Integer;

Parámetros

Description	Lo que muestra la imagen, expresado con palabras. No se admite una descripción vacía

Valores devueltos

1	Se obtuvo la descripción
0	La descripción estaba vacía y no se registró nada

Observaciones

Un lector lee esta descripción en lugar de la imagen, por lo que constituye toda la información que obtiene de ella una persona que no puede verla. Describa lo que muestra la imagen, no solo que existe

La descripción se consume en la siguiente imagen dibujada, por lo que una imagen posterior nunca la hereda. Solo surte efecto mientras SetAutoTagMode incluya las figuras; de lo contrario, la imagen se dibuja sin etiquetar y se descarta la descripción

Para una regla, borde o fondo sin significado, use RegisterDecoration: una figura sin nada que comunicar interrumpe innecesariamente al lector

Ejemplo

PDF.SetAutoTagMode(AUTOTAG_DEFAULT);
PDF.RegisterFigure('Quarterly revenue, rising from 2024 to 2026');
PDF.DrawImage(72, 100, 300, 200);      // a Figure carrying that description
PDF.RegisterDecoration;
PDF.DrawImage(72, 320, 300, 4);        // a rule: an artifact a reader skips

Véase también

RegisterDecoration, SetAutoTagMode, RegisterHeading, BeginTagEx