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تم تعيين اللغة بنجاح