BeginTagEx

Pažymėtas PDF, pritaikymas neįgaliesiems

Aprašymas

Atveria pažymėtojo PDF struktūros elementą esamajame puslapyje su aiškiuoju natūraliosios kalbos atributu. Identiška BeginTag, bet prideda Lang parametrą, rašomą į struktūros elemento /Lang atributą

Naudokite šią funkciją turiniui, kurio kalba skiriasi nuo numatytosios dokumento kalbos (nustatomos SetPDFUAMode arba SetDocumentLanguage). ISO 14289-1 §7.2 reikalauja, kad /Lang atributas būtų nustatytas kiekvienam teksto segmentui, kuris nėra pagrindine dokumento kalba.

Žymos turi būti subalansuotos: po kiekvieno BeginTagEx kvietimo turi sekti atitinkamasis EndTag kvietimas. Žymos gali būti įdėtos

Sintaksė

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

Parametrai

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	Alternatyvusis tekstas vaizdams ir kitam netekstiniam turiniui (`/Alt` atributas). Jei nereikia, perduokite tuščią eilutę
ActualText	Pakeitimasis tekstas turiniui, kurio vizualinė forma skiriasi nuo loginės prasmės (`/ActualText` atributas). Jei nereikia, perduokite tuščią eilutę
Lang	BCP 47 kalbos žyma šio elemento turiniui, pvz., `en-US`, `fr-FR`, `zh-Hans`. Perduokite tuščią eilutę, kad būtų paveldėta dokumento kalba. Kai netuščioji, ji perrašo dokumento lygio kalbą šiam elementui ir visiems jo palikuonims

Grąžinamos reikšmės

0	Nepavyko (neatidarytas dokumentas)
1	Tag opened successfully

Pavyzdys

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