SetStructElemLang

Маркиран PDF & достъпност

Описание

Задава записа /Lang върху структурния елемент, който в момента се изгражда в стека на таговете. Езиковият таг отменя езика на ниво документ за този елемент и за всички негови наследници, което позволява на многоезичните документи да заявят правилния естествен език за всеки откъс от съдържание

Синтаксис

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

Параметри

Върната стойност

Връща 1 при успех, 0 ако няма отворен структурен елемент или не е избран документ

Забележки

Извикайте тази функция непосредствено след BeginTag или BeginTagEx, докато целевият елемент е най-горе в стека на таговете. Тя е еквивалентна на подаване на ненулев аргумент Lang към BeginTagEx, но може да е по-удобна, когато езикът се определя отделно от типа на елемента

Записът /Lang на ниво елемент е дефиниран в ISO 32000-1 §14.9.2. Той се прилага за структурния елемент и по наследяване за всички негови дочерни елементи, които сами не декларират /Lang. Екранните четци използват този запис, за да изберат подходящ глас за синтез на реч или езиков механизъм при прочитане на документа на глас

PDF/UA-1 (ISO 14289-1 §7.3) изисква цялото съдържание на естествен език да бъде идентифицирано. Записът /Lang на ниво документ, зададен чрез SetDocumentLanguage или SetPDFUAMode, покрива основния език; SetStructElemLang покрива разделите, чийто език се различава от основния

Пример

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

Вижте също

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics