SetDocumentLanguageA
خصائص المستند، إمكانية الوصول
الوصف
تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ SetDocumentLanguage وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية
يضبط اللغة الطبيعية للمستند في كتالوج PDF (مدخل /Lang). وتستخدم قارئات الشاشة وتقنيات المساعدة الأخرى إعلان اللغة لتطبيق قواعد النطق وتحويل النص إلى كلام الصحيحة
تكتب هذه الدالة مفتاح Catalog /Lang مباشرة. وعند استخدام وضع PDF/UA ينبغي بدلًا من ذلك توفير اللغة عبر معامل Language في SetPDFUAMode، الذي يستدعي هذه الدالة داخليًا
الصيغة
Delphi
Function DLSetDocumentLanguageA(InstanceID: Integer; Language: PAnsiChar): Integer;
DLL
int DLSetDocumentLanguageA(int InstanceID, const char * Language);
المعاملات
| Language | وسم لغة BCP 47 يُكتب في مدخل /Lang (ISO 32000-1 §14.9.2)، مثل en-US وfr وzh-Hant-TW. مرِّر سلسلة فارغة لوراثة لغة المستند |
|---|
قيم الإرجاع
| 0 | كانت سلسلة اللغة فارغة؛ لم يطرأ أي تغيير |
|---|---|
| 1 | تم تعيين اللغة بنجاح |