BeginTagA

ملف PDF ذو بنية، إمكانية الوصول

الوصف

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

يفتح عنصر بنية PDF موسوم على الصفحة الحالية. يكتب عامل BDC‏ (بدء محتوى موسوم مع قاموس) إلى تدفق المحتوى ويسجل العنصر في شجرة البنية المنطقية للمستند. وتُستكمل شجرة البنية تلقائيًا عند حفظ المستند

يجب أن تكون الوسوم متوازنة: كل استدعاء BeginTag يجب أن يليه استدعاء EndTag موافق. ويمكن تداخل الوسوم

الصيغة

Delphi

Function DLBeginTagA(InstanceID: Integer; TagType, AltText, ActualText: PAnsiChar): Integer;

DLL

int DLBeginTagA(int InstanceID, const char * TagType, const char * AltText, const char * ActualText);

المعاملات

TagType	نوع بنية PDF قياسي: `P`، `H1`–`H6`، `Figure`، `Table`، `TR`، `TH`، `TD`، `L`، `LI`، `LBody`، `Span`، `Link`، `Note` وهكذا (راجع ISO 32000-1 §14.8.4)
AltText	نص بديل للصور وغيرها من المحتويات غير النصية (خاصية `/Alt`). مرِّر سلسلة فارغة إن لم يكن مطلوبًا
ActualText	نص بديل للمحتوى الذي يختلف تمثيله المرئي عن معناه المنطقي (يقابل خاصية `/ActualText` في PDF). مرِّر سلسلة فارغة إن لم يكن مطلوبًا

قيم الإرجاع

0	فشل (لا يوجد مستند مفتوح)
1	Tag opened successfully

مثال

// Heading, then a paragraph
PDF.SetPDFUAMode('en-US');
PDF.BeginTag('H1', '', '');
PDF.PrintText(50, 750, 'Introduction');
PDF.EndTag;
PDF.BeginTag('P', '', '');
PDF.PrintText(50, 730, 'This document demonstrates tagged PDF.');
PDF.EndTag;

// Figure with alt text
PDF.BeginTag('Figure', 'Company logo', '');
PDF.DrawImage(50, 650, 120, 60, 'logo.png');
PDF.EndTag;

ملاحظات

استخدم BeginArtifact/EndArtifact للمحتوى الزخرفي (ترويسات الصفحات وتذييلاتها وعناصر الخلفية) الذي لا ينبغي لقارئات الشاشة أن تقرأه

يجب أن يكون المستند في وضع الكتابة (منشأ أو مفتوحًا للتعديل). استدعِ SetPDFUAMode قبل الوسم استيفاءً لمتطلبات PDF/UA-1