PDFium Delphi Component Docs

Language-egenskap

Component: TPdf  ·  Unit: PDFium
Språkidentifierare som deklareras i dokumentkatalogen

Syntax

property Language: WString; // read / write

Description

Language läser och skriver dokumentkatalogens /Lang-post (PDF 1.7-specifikationen avsnitt 14.9.2). Strängen följer syntaxen för RFC 3066 / BCP 47-språktaggar — en, en-US, zh-Hans, ja-JP osv. Skärmläsare och tillgänglighetsverktyg (PDF/UA, JAWS, NVDA) använder denna tagg för att välja rätt uttalsmotor när taggad text läses högt

Returnerar en tom sträng när Active är False eller när dokumentet inte deklarerar /Lang. Tilldelning av ett nytt värde uppdaterar katalogen omedelbart, men ändringen sparas bara bestående av nästa anrop till SaveToFile / SaveToStream. Språkåsidosättningar på span-nivå för enskilda textstrukturelement (satta via /Lang-posten på en strukturelementsordbok) exponeras inte av denna egenskap

Language är oberoende av den kodning som används för textinnehållet — PDFium avkodar alltid teckendata till UTF-16, oavsett språk. Taggen är ren metadata, främst relevant för taggade / PDF-UA-tillgängliga dokument och för indexeringsmotorer som dirigerar extraherad text genom språkspecifika tokeniserare

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