BeginTagEx2

Tagged PDF & Accessibility

Description

يفتح عنصر بنية جديدًا ويدفعه إلى مكدس الوسوم، مع تعيين جميع خصائص العنصر الرئيسية في استدعاء واحد؛ يعد BeginTagEx2 غلافًا ملائمًا لـ BeginTagEx يليه SetStructElemTitle، وSetStructElemID، وSetStructElemExpansion؛ يؤدي تمرير سلسلة فارغة لأي من Title أو ElemID أو Expansion إلى تخطي أداة التعيين المقابلة؛ وتتصرف المعلمات الأخرى بشكل متطابق مع BeginTagEx

استخدم BeginTagEx2 عندما تعرف بالفعل جميع الخصائص الوصفية للعنصر في وقت فتحه، لتجنب العديد من استدعاءات التعيين المتتالية؛ وإذا تم تحديد أي خاصية لاحقًا (على سبيل المثال، وصول AltText بشكل غير متزامن)، فاستخدم BeginTag أو BeginTagEx واستدعِ دوال التعيين الفردية بعد ذلك

Syntax

Delphi

Function TPDFlib.BeginTagEx2(Const TagType, AltText, ActualText, Lang, Title, ElemID, Expansion: WideString): Integer;

ActiveX

Function PDFlib::BeginTagEx2(TagType As String, AltText As String, ActualText As String, Lang As String, Title As String, ElemID As String, Expansion As String) As Long

DLL

int DLBeginTagEx2(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * ActualText, const wchar_t * Lang, const wchar_t * Title, const wchar_t * ElemID, const wchar_t * Expansion);

Parameters

TagType	اسم نوع عنصر البنية، على سبيل المثال `Figure` و `Table` و `Span` و `P`؛ وهي نفس الأنواع المقبولة بواسطة BeginTag
AltText	النص البديل المكتوب في إدخال /Alt (ISO 32000-1 §14.9.3)؛ مرر سلسلة فارغة للحذف
ActualText	النص الفعلي المكتوب في إدخال /ActualText (ISO 32000-1 §14.9.4)؛ مرر سلسلة فارغة للحذف
Lang	علامة لغة BCP 47 المكتوبة في إدخال /Lang (ISO 32000-1 §14.9.2)، على سبيل المثال `en-US` أو `fr` أو `zh-Hant-TW`؛ مرر سلسلة فارغة لوراثة لغة المستند
Title	التسمية التوضيحية المقروءة بشرياً والمكتوبة في إدخال /T (ISO 32000-1 §14.7.2)؛ وتظهر في لوحة تنقل Tags؛ مرر سلسلة فارغة للحذف
ElemID	معرف عنصر فريد مكتوب في إدخال /ID (المواصفة ISO 32000-1 §14.7.4)؛ ويجب أن يكون فريدًا داخل المستند إذا تم تعيينه؛ مرر سلسلة فارغة لإغفاله
Expansion	توسيع لاختصار أو اسم أوائل الحروف مكتوب في إدخال /E (ISO 32000-1 §14.9.5)؛ مرر سلسلة فارغة للحذف

Return value

يرجع 1 في حالة النجاح، أو 0 إذا لم يتم تحديد أي مستند

Remarks

استدع EndTag مرة واحدة لكل استدعاء ناجح لـ BeginTagEx2 لسحب العنصر من مكدس العلامات؛ يمكن أن تكون عناصر البنية متداخلة: يؤدي استدعاء BeginTagEx2 أثناء فتح عنصر آخر إلى إنشاء عنصر فرعي

التنفيذ الداخلي مكافئ تمامًا لـ:

BeginTagEx(TagType, AltText, ActualText, Lang);
if Title <> '' then SetStructElemTitle(Title);
if ElemID <> '' then SetStructElemID(ElemID);
if Expansion <> '' then SetStructElemExpansion(Expansion);

تظل أدوات التعيين الفردية متاحة للخصائص المحددة بعد فتح العنصر، أو للخصائص التي لا تغطيها BeginTagEx2 (مثل AddTagAttribute لسمات خلايا الجدول)

Example

// Tag a figure with all descriptive properties in one call
PDFlib.BeginTagEx2(
  'Figure',                              // TagType
  'Bar chart: Q1 120, Q2 145, Q3 98',   // AltText
  '',                                    // ActualText (not needed for images)
  '',                                    // Lang (inherit document language)
  'Figure 3: Quarterly Sales',           // Title
  'fig-quarterly-sales',                 // ElemID
  ''                                     // Expansion (not an abbreviation)
);
PDFlib.SetStructElemBBox(x, y, x + w, y + h);
PDFlib.DrawImage(imgHandle, x, y, w, h);
PDFlib.EndTag;

// Tag an acronym span with its expansion
PDFlib.BeginTagEx2(
  'Span',
  '',                                          // AltText
  '',                                          // ActualText
  '',                                          // Lang
  '',                                          // Title
  '',                                          // ElemID
  'World Wide Web Consortium'                  // Expansion
);
PDFlib.WriteText('W3C');
PDFlib.EndTag;