SetAutoTagMode
Getagde PDF
Beschrijving
Turns on structure tagging that ordinary drawing calls carry by themselves.
Syntaxis
Delphi
Function TPDFlib.SetAutoTagMode(Mode: Integer): Integer;Parameters
| Mode | Een bitmasker: 1 tagt tekst, 2 markeert paginameubilair als artefacten, 4 tagt afbeeldingen als figures, 8 tagt getekende tabellen, 15 doet alle vier, 0 schakelt dit uit |
|---|
Retourwaarden
| Mode | De modus die vóór deze aanroep gold |
|---|---|
| 0 | Wordt ook teruggegeven wanneer een negatieve modus wordt doorgegeven; die wordt geweigerd en de modus blijft ongewijzigd |
Opmerkingen
Met teksttagging aan wordt tekst als alinea getagd, en tekst die direct na RegisterHeading wordt getekend als kop van dat niveau. Met meubelmarkering aan worden doorlopende kop- en voetteksten als artifacts gemarkeerd, zodat een reader ze overslaat in plaats van dezelfde regel op elke pagina aan te kondigen
Met figure-tagging ingeschakeld wordt een getekende afbeelding een figure met de beschrijving die door RegisterFigure is achtergelaten, of wordt de afbeelding binnen een layout-artifact getekend wanneer RegisterDecoration heeft aangegeven dat de afbeelding geen betekenis heeft
Met tabeltagging aan neemt DrawTableRows de tabel, zijn rijen en cellen mee in de structuurboom. De rijen die SetTableHeaderRowCount noemt worden headercellen
Het aanzetten van de modus markeert het document ook als getagd. Een reader behandelt structuur als afwezig totdat die markering er staat, dus een getagd document zonder die markering leest alsof het helemaal geen structuur heeft
Automatisch taggen houdt zich afzijdig binnen een tag die met BeginTag is geopend: terwijl de aanroeper de structuur zelf beschrijft, wordt er niets genest in wat hij heeft geopend. Hij tagt ook nooit binnen een artifact — een structuurelement daar zou het bestand ongeldig maken — en opent nooit een element voor lege tekst, die een reader als blanco zou aankondigen
De modus hoort bij de library-instantie, niet bij een document
Voorbeeld
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 artifactZie ook
GetAutoTagMode, RegisterHeading, BeginTag, BeginArtifact, RegisterFigure, RegisterDecoration, SetTableHeaderRowCount