PDFium Delphi Component Docs

Language الخاصية

Component: TPdf  ·  Unit: PDFium
مُعرّف اللغة الطبيعية المصرّح به في كتالوج المستند

Syntax

property Language: WString; // read / write

Description

تقرأ الخاصية Language مدخل /Lang في كتالوج المستند وتكتبه (القسم 14.9.2 من مواصفة PDF 1.7). ويتبع النص تركيب وسم لغة RFC 3066 / BCP 47 — مثل en و en-US و zh-Hans و ja-JP. وتستخدم قارئات الشاشة وأدوات الإتاحة (PDF/UA و JAWS و NVDA) هذا الوسم لاختيار محرك النطق الصحيح عند قراءة النص الموسوم بصوت عالٍ.

تُرجع نصًا فارغًا عندما تكون Active تساوي False أو عندما لا يصرّح المستند /Lang. ويحدّث إسناد قيمة جديدة الكتالوج فورًا لكن التغيير لا يُحفظ إلا عند استدعاء SaveToFile / SaveToStream التالي. أما تجاوزات اللغة على مستوى المقاطع في عناصر بنية نص مفردة (المضبوطة عبر مدخل /Lang في قاموس عنصر بنية) فلا تكشفها هذه الخاصية.

اللغة مستقلة عن الترميز المستخدم لمحتوى النص — فيفك 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