PDFium Delphi Component Docs

Language ویژگی

کامپوننت: TPdf  ·  واحد: 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 روی یک دیکشنری عنصر ساختار) توسط این ویژگی افشا نمی‌شوند

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