PDFium Delphi Component Docs

Language Свойство

Компонент: TPdf  ·  Модуль: PDFium
Идентификатор естественного языка, объявленный в каталоге документа

Syntax

property Language: WString; // read / write

Description

Language читает и записывает запись /Lang каталога документа (спецификация PDF 1.7, раздел 14.9.2). Строка следует синтаксису языковых тегов RFC 3066 / BCP 47 — en, en-US, zh-Hans, ja-JP и т. д. Программы чтения с экрана и вспомогательные инструменты (PDF/UA, JAWS, NVDA) используют этот тег для выбора корректного движка произношения при чтении размеченного текста вслух

Возвращает пустую строку, когда Active равно False или когда документ не объявляет /Lang. Присвоение нового значения обновляет каталог немедленно, но изменение сохраняется только при следующем вызове SaveToFile / SaveToStream. Переопределения языка на уровне интервалов для отдельных элементов структуры текста (заданные через запись /Lang в словаре элемента структуры) этим свойством не предоставляются

Language не зависит от кодировки, используемой для текстового содержимого — PDFium всегда декодирует символьные данные в UTF-16 независимо от языка. Тег является исключительно метаданными, в основном значимыми для размеченных / доступных документов PDF-UA и для индексирующих движков, направляющих извлечённый текст через языково-специфичные токенизаторы

Remarks

Example

if Pdf1.Language = '' then
begin
  Pdf1.Language := 'en-US';
  Pdf1.SaveToFile('tagged.pdf');
end
else
  Label1.Caption := 'Document language: ' + Pdf1.Language;

See Also

IsTagged, MetaText, Title, StructureElements