EndTag

Tagged PDF, Akadálymentesítés

Leírás

Bezárja a címkekötegben legutóbb megnyitott struktúraelemet, EMC (End Marked Content) operátort ír az aktuális oldal tartalomadatfolyamába, és leveszi az elemet a kötegről. A BeginTag, BeginTagEx vagy BeginTagEx2 minden hívásához pontosan egy EndTag hívásnak kell tartoznia a dokumentum mentése vagy a következő oldal hozzáadása előtt

Szintaxis

Delphi

Function TPDFlib.EndTag: Integer;

ActiveX

Function PDFlib::EndTag() As Long

DLL

int DLEndTag(int InstanceID);

Visszatérési értékek

0Sikertelen — nincs megnyitott dokumentum, vagy a címkeverem üres (az EndTag hívása többször történt meg, mint a megfelelő Begin* függvények hívása)
1A struktúraelem lezárása sikerült

Megjegyzések

A címkéknek tisztán kell egymásba ágyazódniuk. Minden EndTag a legbelső nyitott struktúraelemet zárja le; a zárási sorrend szigorúan a nyitási sorrend fordítottja, ugyanúgy, ahogyan a szokásos blokkelemek egymásba ágyazódnak HTML-ben vagy XML-ben

Ha a dokumentum mentésekor egy vagy több struktúraelem még nyitva van, a GetPDFUADiagnostics a STRUCT-UNCLOSED kód alatt jelenti a számukat. A le nem zárt elemek hiányoznak a mentett struktúrafából, ezért az egyes oldalakon található megfelelő megjelölt tartalmi szakaszoknak nincs logikai szülőjük — a segítő technológia átugorja őket

Ne használja az EndTag metódust a BeginArtifact által megnyitott artifact-régió lezárására; ehhez az EndArtifact metódust hívja. Az artifactok és struktúraelemek független megjelölt tartalomvermeken élnek

Példa

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

Lásd még

BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics