BeginTagExA
ملف PDF ذو بنية، إمكانية الوصول
الوصف
تشير اللاحقة A إلى نقطة إدخال DLL الخاصة بـ ANSI (char)؛ وتوفر واجهة ActiveX/COM صيغة Unicode فقط. السلوك مطابق لـ BeginTagEx، وتُفسَّر وسائط السلاسل باستخدام صفحة الرموز الحالية في SetAnsiMode
يفتح عنصر بنية PDF موسوم على الصفحة الحالية مع خاصية لغة طبيعية صريحة. مطابق لـ BeginTag لكنه يضيف معامل Lang يُكتب في خاصية /Lang لعنصر البنية
استخدم هذه الدالة للمحتوى الذي تختلف لغته عن اللغة الافتراضية للمستند (التي تضبطها SetPDFUAMode أو SetDocumentLanguage). يتطلب ISO 14289-1 §7.2 ضبط خاصية /Lang على أي مقطع نصي ليس بلغة المستند الأساسية
يجب أن تكون الوسوم متوازنة: كل استدعاء BeginTagEx يجب أن يليه استدعاء EndTag موافق. ويمكن تداخل الوسوم
الصيغة
Delphi
Function DLBeginTagExA(InstanceID: Integer; TagType, AltText, ActualText, Lang: PAnsiChar): Integer;DLL
int DLBeginTagExA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText, const char * Lang);المعاملات
| TagType | نوع بنية PDF قياسي: P، H1–H6، Figure، Table، TR، TH، TD، L، LI، LBody، Span، Link، Note وهكذا (راجع ISO 32000-1 §14.8.4) |
|---|---|
| AltText | يخدم AltText وActualText غرضين مختلفين. فـ AltText بديل نصي كامل للعنصر بأكمله — يحل محل المحتوى المرئي للمستخدمين غير القادرين على إدراك المخرجات المعروضة. أما ActualText (ISO 32000-1 §14.9.4) فيوفر تسلسل محارف Unicode الدقيق للحروف الرابطة (ligatures) التي يكون نصها المستخرج خاطئًا سواها، ولا يحل محل العرض. وتنطق قارئات الشاشة عادة AltText لعناصر Figure وFormula، وتستخدم ActualText للتصحيحات على مستوى المحارف |
| ActualText | نص بديل للمحتوى الذي يختلف شكله المرئي عن معناه المنطقي (خاصية /ActualText). مرِّر سلسلة فارغة إن لم يكن مطلوبًا |
| Lang | لغة BCP 47 مرمزة وفق وضع ANSI للمثيل |
قيم الإرجاع
| 0 | فشل (لا يوجد مستند مفتوح) |
|---|---|
| 1 | Tag opened successfully |
مثال
// Document in English with a French citation
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 750, 'The French motto is:');
PDF.EndTag;
PDF.BeginTagEx('Span', '', '', 'fr-FR');
PDF.PrintText(50, 730, 'Liberté, Égalité, Fraternité');
PDF.EndTag;