EndTag

Tagged PDF, saavutettavuus

Kuvaus

Sulkee viimeisimmän tagipinoon avatun rakennetyylielementin kirjoittamalla EMC- (End Marked Content) operaattorin nykyisen sivun sisältövirtaan ja poistamalla elementin pinosta. Jokaisen BeginTag-, BeginTagEx- tai BeginTagEx2-kutsun on vastattava täsmälleen yksi EndTag-kutsu ennen asiakirjan tallennusta tai seuraavan sivun lisäämistä

Syntaksi

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Paluuarvot

0	Epäonnistui — dokumenttia ei ole avoinna tai tunnistepino on tyhjä (`EndTag`-funktiota kutsuttiin useammin kuin vastaavia `Begin*`-funktioita)
1	Rakennetyylielementin sulkeminen onnistui

Huomautukset

Tagien on sisäkkäistyttävä siististi. Jokainen EndTag sulkee sisimmän avoimen rakennetyylielementin; sulkujärjestys on tarkalleen avausjärjestyksen käänteinen, samalla tavalla kuin tavallisten lohkoelementtien sisäkkäistyminen HTML:ssä tai XML:ssä

Jos asiakirja tallennetaan, kun yksi tai useampi rakennetyylielementti on yhä avoinna, GetPDFUADiagnostics raportoi määrän koodilla STRUCT-UNCLOSED. Sulkemattomat elementit puuttuvat tallennetusta rakennepuusta, joten vastaavat marked content -osiot o

Älä sulje BeginArtifactilla avattua artifact-aluetta funktiolla EndTag· siihen kutsu EndArtifactia. Artifactit ja rakennetyypin elementit elävät itsenäisissä marked content -pinoluissa.

Esimerkki

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

Katso myös

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics