BeginTagEx

Tagovaný PDF, prístupnosť

Opis

Otvorí na aktuálnej strane štruktúrny prvok tagovaného PDF s výslovným atribútom prirodzeného jazyka. Identické s BeginTag, pridáva však parameter Lang, ktorý sa zapíše do atribútu /Lang štruktúrneho prvku.

Túto funkciu použite pre obsah, ktorého jazyk sa líši od predvoleného jazyka dokumentu (nastaveného cez SetPDFUAMode alebo SetDocumentLanguage). ISO 14289-1 §7.2 vyžaduje, aby atribút /Lang bol nastavený na každom textovom segmente, ktorý nie je v hlavnom jazyku dokumentu.

Tagy musia byť vyvážené: každé volanie BeginTagEx musí nasledovať zodpovedajúce volanie EndTag. Tagy môžu byť vnorené.

Syntax

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);

Parametre

TagType	PDF standard structure type: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note`, etc. (see ISO 32000-1 §14.8.4).
AltText	Alternatívny text pre obrázky a iný netextový obsah (atribút `/Alt`). Ak nie je potrebný, odovzdajte prázdny reťazec.
ActualText	Náhradný text pre obsah, ktorého vizuálna podoba sa odlišuje od logického významu (atribút `/ActualText`). Ak nie je potrebný, odovzdajte prázdny reťazec.
Lang	Jazyková značka BCP 47 pre obsah tohto prvku, napr. `en-US`, `fr-FR`, `zh-Hans`. Na zdedenie jazyka dokumentu odovzdajte prázdny reťazec. Keď nie je prázdna, pre tento prvok a všetkých jeho potomkov prepisuje jazyk na úrovni dokumentu.

Návratové hodnoty

0	Failed (no document is open)
1	Tag opened successfully

Príklad

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