SetStructElemTitle

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

الوصف

يضبط مدخل /T‏ (العنوان) على عنصر البنية قيد البناء حاليًا على رصة الوسوم. العنوان تسمية مقروءة للإنسان تميز العنصر المحدد — مثل Chapter 1 أو Summary Table أو Figure 3: Quarterly Sales — بدلًا من مجرد تكرار نوع العنصر

الصيغة

Delphi

Function TPDFlib.SetStructElemTitle(Const Title: WideString): Integer;

ActiveX

Function PDFlib::SetStructElemTitle(Title As String) As Long

DLL

int DLSetStructElemTitle(int InstanceID, const wchar_t * Title);

المعاملات

قيمة الإرجاع

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

ملاحظات

يعرّف ISO 32000-1 §14.7.2 Table 324 مدخل /T. ويُكتب كسلسلة نص PDF في قاموس عنصر البنية

يخدم Title غرضًا مختلفًا عن خصائص النص الأخرى في عنصر البنية:

• /T (Title) — تسمية وصفية للعنصر تُستخدم في لوحات التنقل والوسم. مناسبة لعناوين الأقسام وتسميات الجداول والتسميات التوضيحية للأشكال.
• /Alt (انظر SetStructElemAltText) — بديل نصي كامل للعنصر تستخدمه تقنيات المساعدة عندما يتعذر عرض العنصر.
• /ActualText (انظر SetStructElemActualText) — بديل Unicode دقيق لمتتاليات المحارف التي سيكون نصها المستخرج غير صحيح لولا ذلك.

يستخدم عارضات PDF مدخل /T لتسمية العناصر في لوحة تنقل الوسوم. وتستخدمه أدوات إمكانية الوصول وبرامج المعالجة كعنوان معلم للتنقل في المستند. وفي عناصر العناوين (H1–H6) يخدم محتوى العنصر نفسه كنص العنوان؛ وـ /T أنفع للعناصر غير النصية (Table وFigure وForm) أو الحاويات (Sect وDiv) التي تحتاج تسمية وصفية

مثال

// Tag a data table with a title for navigation and accessibility tools
PDFlib.BeginTag('Table', '', '');
PDFlib.SetStructElemTitle('Table 2: Annual Revenue by Region');
// ... table rows and cells
PDFlib.EndTag;

// Tag a document section
PDFlib.BeginTag('Sect', '', '');
PDFlib.SetStructElemTitle('Chapter 3: Implementation');
// ... section content
PDFlib.EndTag;

انظر أيضا

BeginTag, SetStructElemAltText, SetStructElemActualText, SetStructElemID, GetPDFUADiagnostics