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
| 0 | Sikertelen — 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) |
|---|---|
| 1 | A 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; // SectLásd még
BeginTag, BeginTagEx, BeginTagEx2, EndArtifact, GetPDFUADiagnostics