BeginMarkedContent
PDF المُعلَّم، إمكانية الوصول
الوصف
يفتح نطاق محتوى معلَّم في تدفق المحتوى الحالي بكتابة عامل BDC (Begin Marked Content with Property List). يُستخدم هذا عادةً لإنشاء PDF مهيكل (معلَّم) يلبي متطلبات إمكانية الوصول (مثل PDF/UA)يجب أن تكون نطاقات المحتوى المعلَّم متوازنة تمامًا: كل استدعاء لـ
BeginMarkedContent يجب إغلاقه باستدعاء مقابل لـ EndMarkedContent. ويمكن تداخل نطاقات المحتوى المعلَّم
الصيغة
Delphi
Function TPDFlib.BeginMarkedContent(Const TagType, AltText, ActualText, Lang, Expansion: WideString): Integer;المعاملات
| TagType | اسم الوسم البنيوي، مثل /Span و /P و /Figure وهكذا |
|---|---|
| AltText | نص وصف بديل لإمكانية الوصول (يقابل مفتاح /Alt في قائمة الخصائص). مرّر سلسلة فارغة عند عدم الحاجة |
| ActualText | النص الفعلي الذي يستبدل تمثيل المحارف لقارئات الشاشة (يقابل مفتاح /ActualText). مرّر سلسلة فارغة عند عدم الحاجة |
| Lang | رمز اللغة الطبيعية للمحتوى المعلَّم (مثل en-US، يقابل مفتاح /Lang). مرّر سلسلة فارغة عند عدم الحاجة |
| Expansion | نص التوسعة للاختصارات أو المبادئ (يقابل مفتاح /E). مرّر سلسلة فارغة عند عدم الحاجة |
قيم الإرجاع
| 0 | لا يوجد مستند مفتوح أو فشل كتابة المحتوى المعلَّم |
|---|---|
| 1 | فُتح نطاق المحتوى المعلَّم بنجاح |
ملاحظات
لبناء ملفات PDF/UA معلَّمة مطابقة، تأكد من أن وسوم البنية المنطقية تحيط بكل النصوص والرسوميات المرئية. توفر هذه الدالة مطابقة خصائص دقيقة مقارنة بـ BeginTag
مثال
// Heading, then a paragraph with marked content span
PDF.NewDocument;
PDF.AddPage;
PDF.BeginMarkedContent('/Span', 'Logo description', '', 'en-US', '');
// Draw graphics or print text here
PDF.EndMarkedContent;