EndTag

Tagged PDF, Tilgængelighed

Beskrivelse

Lukker det senest åbnede strukturelement på tagstakken, skriver en EMC-operator (slut på mærket indhold) til den aktuelle sides indholdsstrøm og fjerner elementet fra stakken. Hvert kald til BeginTag, BeginTagEx eller BeginTagEx2 skal modsvares af præcis ét kald til EndTag, før dokumentet gemmes, eller den næste side tilføjes.

Syntaks

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Returværdier

0	Mislykkedes — intet dokument er åbent, eller tagstakken er tom (`EndTag` blev kaldt flere gange end de tilsvarende `Begin*`-funktioner)
1	Strukturelementet blev lukket.

Bemærkninger

Tags skal indlejres korrekt. Hvert EndTag lukker det inderste åbne strukturelement; lukkerækkefølgen er strengt den omvendte af åbningsrækkefølgen, på samme måde som almindelige blokelementer indlejres i HTML eller XML.

Hvis et dokument gemmes med et eller flere stadig åbne strukturelementer, rapporterer GetPDFUADiagnostics antallet under koden STRUCT-UNCLOSED. Ulukkede elementer mangler i det gemte strukturtræ, så de tilsvarende sektioner med markeret indhold på hver side ikke har nogen logisk overordnet node — hjælpeteknologi springer dem over

Brug ikke EndTag til at lukke et artefaktområde, der blev åbnet med BeginArtifact; kald EndArtifact til det. Artefakter og strukturelementer findes på uafhængige stakke med markeret indhold

Eksempel

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

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics