EndTag

Tagged PDF, Přístupnost

Popis

Zavře naposledy otevřený strukturní element na zásobníku tagů, zapíše operátor EMC (End Marked Content) do obsahového proudu aktuální stránky a element ze zásobníku sundá. Každé volání BeginTag, BeginTagEx nebo BeginTagEx2 musí mít přesně jedno párové volání EndTag dřív, než se dokument uloží nebo přidá další stránka

Syntaxe

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Návratové hodnoty

0	Selhání — není otevřen žádný dokument nebo je zásobník značek prázdný (funkce `EndTag` byla volána vícekrát než odpovídající funkce `Begin*`)
1	Strukturní element se úspěšně zavřel

Poznámky

Tagy se musí čistě zanořovat. Každý EndTag zavře nejvnitřnější otevřený strukturní element; pořadí zavírání je striktně obrácené pořadí otevírání, stejně jako se obyčejné blokové elementy zanořují v HTML nebo XML

If a document is saved with one or more structure elements still open, GetPDFUADiagnostics reports the count under the STRUCT-UNCLOSED code. Unclosed elements are missing from the saved structure tree, so the corresponding marked content sections on each page have no logical parent — assistive technology will skip them.

Do not use EndTag to close an artifact region opened with BeginArtifact; call EndArtifact for that. Artifacts and structure elements live on independent marked-content stacks.

Příklad

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

Viz také

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics