PDFium Component Docs

Language eigenschap

Component: TPdf  ·  Unit: PDFium
Natuurlijk-taal-id gedeclareerd in de documentcatalogus

Syntax

property Language: WString; // read / write

Description

Language leest en schrijft de vermelding /Lang van de documentcatalogus (PDF 1.7-specificatie, sectie 14.9.2). De string volgt de RFC 3066 / BCP 47-taaltagsyntaxis — en, en-US, zh-Hans, ja-JP enz. Schermlezers en toegankelijkheidstools (PDF/UA, JAWS, NVDA) gebruiken deze tag om de juiste uitspraakengine te kiezen bij het hardop voorlezen van getagde tekst.

Retourneert een lege string wanneer Active False is of wanneer het document geen /Lang declareert. Het toewijzen van een nieuwe waarde werkt de catalogus onmiddellijk bij, maar de wijziging wordt alleen bewaard door de volgende SaveToFile / SaveToStream-aanroep. Taaloverrides op span-niveau op individuele tekststructuurelementen (ingesteld via de vermelding /Lang op een structuurelement-woordenboek) worden niet door deze eigenschap weergegeven.

Language is onafhankelijk van de codering die voor tekstinhoud wordt gebruikt — PDFium decodeert tekengegevens altijd naar UTF-16, ongeacht de taal. De tag is puur metagegevens, hoofdzakelijk relevant voor getagde / PDF-UA-toegankelijke documenten en voor indexeringsengines die geëxtraheerde tekst door taalspecifieke tokenisatoren leiden.

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