SetStructElemLangA

PDF المُعلَّم وإمكانية الوصول

الوصف

الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ SetStructElemLang وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode

يضبط مدخل /Lang على عنصر البنية قيد البناء حاليًا على رصة الوسوم. ويتجاوز وسم اللغة لغة المستند على مستوى المستند لهذا العنصر وجميع أحفاده، مما يتيح للمستندات متعددة اللغات الإعلان عن اللغة الطبيعية الصحيحة لكل جزء من المحتوى

الصيغة

Delphi

Function DLSetStructElemLangA(InstanceID: Integer; Lang: PAnsiChar): Integer;

DLL

int DLSetStructElemLangA(int InstanceID, const char * Lang);

المعاملات

قيمة الإرجاع

تُرجع 1 عند النجاح، و0 إذا لم يكن هناك عنصر بنية مفتوح حاليًا أو لا يوجد مستند محدد

ملاحظات

استدعِ هذه الدالة بعد إضافة الملف المضمّن وقبل حفظ المستند

يُعرَّف مدخل /Lang على مستوى العنصر في ISO 32000-1 §14.9.2. وينطبق على عنصر البنية وبالميراث على جميع العناصر الأبناء التي لا تعلن عن /Lang بنفسها. وتستخدم قارئات الشاشة هذا المدخل لاختيار محرك النطق أو الصوت المناسب لتحويل النص إلى كلام عند قراءة المستند بصوت مسموع

يتطلب PDF/UA-1 (ISO 14289-1 §7.3) تعريف كل محتوى بلغة طبيعية. ويغطي /Lang على مستوى المستند الذي تضبطه SetDocumentLanguage أو SetPDFUAMode اللغة الأساسية؛ وتغطي SetStructElemLang الأقسام التي تختلف لغتها عن الأساسية

مثال

// A French phrase embedded in an English document
PDFlib.SetPDFUAMode('en-US');
// ... English content
PDFlib.BeginTag('P', '', '');
PDFlib.SetStructElemLang('fr');
PDFlib.TextOut(x, y, 'Bonjour le monde');
PDFlib.EndTag;

انظر أيضا

BeginTagEx, SetDocumentLanguage, SetPDFUAMode, SetStructElemActualText, GetPDFUADiagnostics