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