BeginTagEx

PDF etichetat, Accesibilitate

Descriere

Deschide un element de structură PDF cu tag-uri pe pagina curentă, cu un atribut explicit de limbă naturală. Identic cu BeginTag, dar adaugă un parametru Lang scris în atributul /Lang al elementului de structură

Folosiți această funcție pentru conținut a cărui limbă diferă de limba implicită a documentului (setată prin SetPDFUAMode sau SetDocumentLanguage). ISO 14289-1 §7.2 cere ca atributul /Lang să fie setat pe orice segment de text care nu este în limba principală a documentului

Tag-urile trebuie să fie echilibrate: fiecare apel BeginTagEx trebuie urmat de un apel EndTag potrivit. Tag-urile pot fi imbricate

Sintaxă

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

Parametri

TagType	Tip de structură standard PDF: `P`, `H1`–`H6`, `Figure`, `Table`, `TR`, `TH`, `TD`, `L`, `LI`, `LBody`, `Span`, `Link`, `Note` etc. (consultați ISO 32000-1 §14.8.4)
AltText	Text alternativ pentru imagini și alte conținuturi non-text (atributul `/Alt`). Transmiteți un șir vid dacă nu este necesar
ActualText	Text de înlocuire pentru conținut a cărui formă vizuală diferă de sensul lui logic (atributul `/ActualText`). Transmiteți un șir vid dacă nu este necesar
Lang	Tag-ul de limbă BCP 47 pentru conținutul acestui element, de exemplu `en-US`, `fr-FR`, `zh-Hans`. Pasați un șir gol pentru a moșteni limba documentului. Când este nevid, suprascrie limba la nivel de document pentru acest element și toți descendenții săi

Valori returnate

0	Eșec (niciun document nu este deschis)
1	Tag opened successfully

Exemplu

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