PDFium Component Docs

Language Eigenschap

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
Component: TPdf  ·  Unit: PDFium
Taalidentifier die in de documentcatalogus is gedeclareerd

Syntaxis

property Language: WString; // read / write

Beschrijving

Language leest en schrijft de /Lang-entry van de documentcatalogus (PDF 1.7 spec section 14.9.2). De string volgt de RFC 3066 / BCP 47 language tag syntax — en, en-US, zh-Hans, ja-JP, enzovoort. Screen readers en accessibility tools (PDF/UA, JAWS, NVDA) gebruiken deze tag om de juiste pronunciation engine te kiezen bij het hardop lezen van tagged text

Geeft een lege string terug wanneer Active False is of wanneer het document /Lang niet declareert. Het toewijzen van een nieuwe waarde werkt de catalogus onmiddellijk bij, maar de wijziging wordt pas vastgelegd door de volgende SaveToFile / SaveToStream-aanroep. Span-level language overrides op individuele text structure elements, ingesteld via de /Lang-entry op een structure element dictionary, zijn niet via deze property zichtbaar

Language staat los van de encoding die voor text content wordt gebruikt — PDFium decodeert karakterdata altijd naar UTF-16, ongeacht de taal. De tag is puur metadata, vooral relevant voor tagged / PDF-UA-toegankelijke documenten en voor indexengines die uitgehaalde tekst via taalspecifieke tokenisers routeren

Opmerkingen

Voorbeeld

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

Zie ook

IsTagged, MetaText, Title, StructureElements