BeginTag

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

الوصف

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

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

الصيغة

Delphi

Function TPDFlib.BeginTag(Const TagType, AltText, ActualText: WideString): Integer;

ActiveX

Function PDFlib::BeginTag(TagType As String, AltText As String, ActualText As String) As Long

DLL

int DLBeginTag(int InstanceID, const wchar_t * TagType, const wchar_t * AltText, const wchar_t * 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

وسم مستند يميزه كموسوم عند حفظه، وهو ما يحتاجه القارئ قبل أن يتعامل مع البنية أصلًا. ويُترك إعداد SetMarkInfo أجراه المستدعي كما هو