SetAutoTagMode

Tagged PDF

Beskrivelse

Aktiverer strukturmærkning, som almindelige tegnekald selv medfører

Syntaks

Delphi

Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;

Parametre

Mode	En bitmaske: `1` tagger tekst, `2` markerer sideinventar som artefakter, `4` tagger billeder som figurer, `8` tagger tegnede tabeller, `15` gør alle fire dele, og `0` deaktiverer funktionen

Returværdier

Mode	Den tilstand, der var gældende før dette kald.
0	Returneres også, når en negativ tilstand angives; den afvises og lader tilstanden være uændret.

Bemærkninger

Når teksttagging er aktiveret, tagges tekst som et afsnit, og tekst, der tegnes umiddelbart efter RegisterHeading, tagges som en overskrift på dette niveau. Når markering af sideinventar er aktiveret, markeres løbende sidehoveder og sidefødder som artefakter, så en læser springer dem over i stedet for at annoncere den samme linje på hver side.

Når figurmærkning er aktiveret, bliver et tegnet billede til en figur med den beskrivelse, der blev angivet med RegisterFigure, eller tegnes i et layoutartefakt, hvis RegisterDecoration angav, at det ikke har nogen betydning

Når tabeltagging er aktiveret, fører DrawTableRows tabellen, dens rækker og dens celler ind i strukturtræet. Rækkerne, der navngives af SetTableHeaderRowCount, bliver overskriftsceller.

Aktivering af tilstanden markerer også dokumentet som mærket. En læser behandler strukturen som fraværende, indtil markeringen findes, så et dokument, der er mærket uden den, læses, som om det slet ikke havde nogen struktur.

Automatisk mærkning træder til side inde i et tag, der er åbnet med BeginTag: mens kalderen selv beskriver strukturen, indlejres intet i det åbnede element. Den mærker heller aldrig inde i et artefakt, hvor et strukturelement ville gøre filen ugyldig, og åbner aldrig et element for tom tekst, som en læser ville annoncere som tom.

Tilstanden tilhører biblioteksinstansen, ikke et dokument.

Eksempel

PDF.SetAutoTagMode(3);
PDF.RegisterHeading(1, 'Chapter One');
PDF.DrawText(72, 100, 'Chapter One');      // tagged H1
PDF.DrawText(72, 130, 'Body text.');       // tagged P
PDF.AddPageFooter('', 'Confidential', 30, 1, 1);  // an artifact

Se også

GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount