SetAutoTagMode

Taggad PDF

Beskrivning

Slår på strukturtaggning som vanliga ritningsanrop bär med sig själva

Syntax

Delphi

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

Parametrar

ModeEn bitmask: 1 taggar text, 2 markerar siddekor som artefakter, 4 taggar bilder som figurer, 8 taggar ritade tabeller, 15 gör alla fyra, 0 stänger av

Returvärden

ModeDet läge som gällde före det här anropet
0Returneras också när ett negativt läge ges, vilket avslås och lämnar läget oförändrat

Anmärkningar

Med texttaggning påslagts taggas text som ett stycke, och text ritad direkt efter RegisterHeading taggas som en rubrik på den nivån. Med dekormarkering på märks löpande sidhuvuden och sidfötter som artefakter, så att en läsare hoppar över dem i stället för att läsa upp samma rad på varje sida

Med figurtaggning på blir en ritad bild en figur som bär beskrivningen från RegisterFigure, eller ritas inuti en layoutartefakt när RegisterDecoration sagt att den inte bär någon mening

Med tabelltaggning på för DrawTableRows in tabellen, dess rader och dess celler i strukturträdet. Raderna som SetTableHeaderRowCount anger blir rubrikceller

Att slå på läget markerar också dokumentet som taggat. En läsare behandlar strukturen som frånvarande tills den markeringen finns, så ett dokument som taggats utan den läses som om det inte hade någon struktur alls

Den automatiska taggningen håller sig undan inuti en tagg öppnad med BeginTag: medan uppringaren själv beskriver strukturen nästlas inget inuti det den öppnat. Den taggar heller aldrig inuti en artefakt, där ett strukturelement skulle göra filen ogiltig, och öppnar aldrig ett element för tom text, som en läsare skulle läsa upp som ett tomrum

Läget tillhör biblioteksinstansen, inte ett dokument

Exempel

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 även

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