SetStructElemLang

pažymėtasis PDF ir prieinamumas

Aprašymas

Nustato /Lang įrašą struktūros elementui, šiuo metu kuriamam žymų dėkle. Kalbos žyma perrašo dokumento lygio kalbą šiam elementui ir visiems jo palikuonims, leisdama mišriakalbiams dokumentams deklaruoti teisingąją natūraliąją kalbą kiekvienam turinio gabalui

Sintaksė

Delphi

Function TPDFlib.SetStructElemLang(Const Lang: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemLang(Lang As String) As Long

DLL

int DLSetStructElemLang(int InstanceID, const wchar_t * Lang);

Parametrai

Lang	BCP 47 kalbos žymos eilutė, tokia kaip `en-US`, `fr`, `de-CH` arba `zh-Hant-TW`. Perduokite tuščią eilutę, kad išvalytumėte anksčiau nustatytąją reikšmę ir būtų paveldėta dokumento lygio kalba

Grąžinama reikšmė

Grąžina 1 sėkmės atveju, 0, jei šiuo metu neatvertas joks struktūros elementas arba nepasirinktas joks dokumentas

Pastabos

Iškvieskite šią funkciją iškart po BeginTag arba BeginTagEx, kol tikslinasis elementas yra žymų dėkelio viršuje. Ji lygi netuščiojo Lang argumento perdavimui BeginTagEx, bet gali būti patogesnė, kai kalba nustatoma atskirai nuo elemento tipo

Elemento lygio /Lang įrašas apibrėžtas ISO 32000-1 §14.9.2. Jis taikomas struktūros elementui ir, paveldint, visiems antriniams elementams, kurie patys nedeklaruoja /Lang. Ekrano skaitytuvai šį įrašą naudoja, kad parinktų tinkamą teksto įgarsinimo balsą ar kalbos variklį skaitant dokumentą garsiai.

PDF/UA-1 (ISO 14289-1 §7.3) reikalauja, kad visa natūralios kalbos turinys būtų identifikuotas. Dokumento lygio /Lang, nustatomas SetDocumentLanguage arba SetPDFUAMode, dengia pagrindinę kalbą; SetStructElemLang dengia sekcijas, kurių kalba skiriasi nuo pagrindinės.

Pavyzdys

// A French phrase embedded in an English document
PDFlib.SetPDFUAMode('en-US');
// ... English content
PDFlib.BeginTag('P', '', '');
PDFlib.SetStructElemLang('fr');
PDFlib.TextOut(x, y, 'Bonjour le monde');
PDFlib.EndTag;

Taip pat žiūrėkite

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics