PDFium Delphi Component Docs

מאפיין Language

Component: TPdf  ·  Unit: 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