EndTag

Taggad PDF, tillgänglighet

Beskrivning

Stänger det senast öppnade strukturelementet på taggstacken, skriver en EMC-operator (End Marked Content) till den aktuella sidans innehållsström och poppar elementet från stacken. Varje anrop av BeginTag, BeginTagEx eller BeginTagEx2 måste matchas av exakt ett EndTag-anrop innan dokumentet sparas eller nästa sida läggs till

Syntax

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Returvärden

0	Misslyckades — inget dokument är öppet, eller taggstacken är tom (`EndTag` anropades fler gånger än motsvarande `Begin*`-funktioner)
1	Strukturelementet stängdes utan problem

Anmärkningar

Taggar måste nästlas rent. Varje EndTag stänger det innersta öppna strukturelementet; stängningsordningen är strikt den omvända öppningsordningen, på samma sätt som vanliga blockelement nästlas i HTML eller XML

Om ett dokument sparas med ett eller flera strukturelement fortfarande öppna rapporterar GetPDFUADiagnostics antalet under koden STRUCT-UNCLOSED. Öppna element saknas i det sparade strukturträdet, så de motsvarande markerade innehållsavsnitten på varje sida saknar logisk förälder – hjälpmedel hoppar över dem.

Använd inte EndTag för att stänga en artefaktregion öppnad med BeginArtifact; anropa EndArtifact för det. Artefakter och strukturelement lever på oberoende marked-content-stackar

Exempel

// Nested structure: a section with a heading and two paragraphs
PDF.BeginTag('Sect', '', '');
  PDF.BeginTag('H1', '', '');
    PDF.PrintText(50, 750, 'Introduction');
  PDF.EndTag;   // H1
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 720, 'First paragraph of the introduction.');
  PDF.EndTag;   // P
  PDF.BeginTag('P', '', '');
    PDF.PrintText(50, 690, 'Second paragraph follows in the same section.');
  PDF.EndTag;   // P
PDF.EndTag;     // Sect

Se även

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics