BeginTagEx

Tagged PDF, Akadálymentesítés

Leírás

Megnyit egy címkézett PDF-struktúraelemet az aktuális oldalon, explicit természetesnyelv-attribútummal. Azonos a BeginTag metódussal, de hozzáad egy Lang paramétert, amely a struktúraelem /Lang attribútumába íródik

Használja ezt a függvényt olyan tartalomhoz, amelynek nyelve eltér a dokumentum alapértelmezett nyelvétől (amelyet a SetPDFUAMode vagy a SetDocumentLanguage állít be). Az ISO 14289-1 §7.2 előírja, hogy a /Lang attribútumot minden olyan szövegszakaszon be kell állítani, amely nem a dokumentum elsődleges nyelvén van

A címkéknek kiegyensúlyozottnak kell lenniük: minden BeginTagEx hívást megfelelő EndTag hívásnak kell követnie. A címkék egymásba ágyazhatók

Szintaxis

Delphi

Function TPDFlib.BeginTagEx(Const TagType, AltText, ActualText, Lang: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx(TagType As String, AltText As String, ActualText As String, Lang As String) As Long

DLL

int DLBeginTagEx(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang);

Paraméterek

TagTypeSzabványos PDF-struktúratípus: P, H1–H6, Figure, Table, TR, TH, TD, L, LI, LBody, Span, Link, Note stb. (lásd: ISO 32000-1 §14.8.4)
AltTextKépek és egyéb nem szöveges tartalom alternatív szövege (/Alt attribútum). Adjon meg üres karakterláncot, ha nem szükséges
ActualTextHelyettesítő szöveg olyan tartalomhoz, amelynek vizuális formája eltér a logikai jelentésétől (/ActualText attribútum). Adjon meg üres karakterláncot, ha nem szükséges
LangBCP 47 nyelvcímke az elem tartalmához, például en-US, fr-FR, zh-Hans. A dokumentumnyelv örökléséhez adjon át üres karakterláncot. Nem üres érték esetén felülírja a dokumentumszintű nyelvet ennél az elemnél és minden leszármazottjánál

Visszatérési értékek

0Sikertelen (nincs nyitott dokumentum)
1A címke sikeresen megnyílt

Példa

// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;