RegisterFigure

Tagged PDF

Beskrivelse

Angiver den beskrivelse, som det næste tegnede billede skal have.

Syntaks

Delphi

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

Parametre

Beskrivelse	En beskrivelse med ord af, hvad billedet viser. En tom beskrivelse afvises

Returværdier

1	Beskrivelsen blev hentet
0	Beskrivelsen var tom, og intet blev registreret

Bemærkninger

En læser læser denne beskrivelse i stedet for billedet, så den udgør alt, hvad en ikke-seende læser får fra det. Beskriv, hvad billedet viser, i stedet for blot at sige, at der er et billede.

Beskrivelsen forbruges af det næste billede, der tegnes, så et senere billede aldrig arver den. Den træder kun i kraft, mens SetAutoTagMode dækker figurer; uden dette tegnes billedet uden tag, og beskrivelsen kasseres.

Brug i stedet RegisterDecoration til en linje, kant eller baggrund uden betydning: En figur uden noget væsentligt at fortælle er værre end slet ingen figur, fordi en læser stopper ved den

Eksempel

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

Se også

RegisterDecoration, SetAutoTagMode, RegisterHeading, BeginTagEx