EndTag

Tagged PDF, Dostępność

Opis

Zamyka ostatnio otwarty element struktury na stosie tagów, zapisując operator EMC (End Marked Content) w strumieniu zawartości bieżącej strony i zdejmując element ze stosu. Każdemu wywołaniu BeginTag, BeginTagEx lub BeginTagEx2 musi odpowiadać dokładnie jedno wywołanie EndTag przed zapisaniem dokumentu lub dodaniem następnej strony

Składnia

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Wartości zwracane

Uwagi

Tagi muszą być prawidłowo zagnieżdżone. Każde EndTag zamyka najbardziej wewnętrzny otwarty element struktury; kolejność zamykania jest ściśle odwrotna do kolejności otwierania, tak jak w zwykłym zagnieżdżaniu elementów blokowych HTML lub XML

Jeśli dokument zostanie zapisany z co najmniej jednym nadal otwartym elementem struktury, GetPDFUADiagnostics zgłosi liczbę pod kodem STRUCT-UNCLOSED. Niezamknięte elementy nie występują w zapisanym drzewie struktury, więc odpowiadające im sekcje zawartości oznaczonej na każdej stronie nie mają logicznego rodzica — technologie wspomagające je pominą

Nie używaj EndTag do zamykania obszaru artefaktu otwartego przez BeginArtifact; w tym celu wywołaj EndArtifact. Artefakty i elementy struktury znajdują się na niezależnych stosach zawartości oznaczonej

Przykład

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

Zobacz również

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics