EndTag

Getagde PDF, toegankelijkheid

Beschrijving

Sluit het meest recent geopende structuurelement op de tagstack, met wegschrijving van een EMC (End Marked Content)-operator naar de contentstream van de huidige pagina en het van de stack halen van het element. Elke aanroep van BeginTag, BeginTagEx of BeginTagEx2 moet gepaard gaan met exact één EndTag-aanroep voordat het document wordt opgeslagen of de volgende pagina wordt toegevoegd

Syntaxis

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Retourwaarden

0	Mislukt — er is geen document geopend of de tagstack is leeg (`EndTag` is vaker aangeroepen dan de bijbehorende `Begin*`-functies)
1	Het structuurelement is met succes gesloten

Opmerkingen

Tags moeten netjes nesten. Elke EndTag sluit het binnenst open staande structuurelement; de sluitvolgorde is strikt het omgekeerde van de openvolgorde, net zoals gewone block-elementen in HTML of XML nesten

Wordt een document opgeslagen terwijl er nog een of meer structuurelementen open staan, dan rapporteert GetPDFUADiagnostics de telling onder de code STRUCT-UNCLOSED. Niet-gesloten elementen ontbreken in de opgeslagen structuurboom, dus de bijbehorende marked-content-secties op elke pagina hebben geen logische parent — hulptechnologie slaat ze over

Gebruik nooit EndTag om een artefactregio te sluiten die met BeginArtifact is geopend; roep daarvoor EndArtifact aan. Artefacts en structuurelementen leven op onafhankelijke marked-content-stacks

Voorbeeld

// 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

Zie ook

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics